Skip to content

preserve allowQuery for partial fallback shells#90887

Merged
ztanner merged 1 commit intocanaryfrom
ztanner/partial-fallback-allowquery
Mar 6, 2026
Merged

preserve allowQuery for partial fallback shells#90887
ztanner merged 1 commit intocanaryfrom
ztanner/partial-fallback-allowquery

Conversation

@ztanner
Copy link
Member

@ztanner ztanner commented Mar 4, 2026

Analogous change to vercel/vercel#15338, but for the new Next.js adapter API.

This updates only allowQuery for fallback HTML when the route is a true partialFallback (PPR fallback with postponed state) and cache components is enabled. For all other fallback cases, behavior stays the same as today (allowQuery is cleared to [] for shared fallback caching).

This change is needed because partial-fallback shells can be param-specific, so collapsing them to one shared fallback cache key can serve the wrong shell across params and block correct upgrade behavior. Gating this behind partialFallback lets us roll out the new behavior safely and independently, without changing legacy fallback semantics for non-partial paths.

Copy link
Member Author

ztanner commented Mar 4, 2026

@ztanner ztanner force-pushed the ztanner/partial-fallback-allowquery branch from 8bfc33f to ed3bb76 Compare March 4, 2026 20:38
@ztanner ztanner marked this pull request as ready for review March 4, 2026 21:11
@ztanner ztanner requested a review from ijjk March 4, 2026 21:11
Base automatically changed from 02-23-partial_fallbacks_add_adapter_flag_tweak_allowquery to canary March 4, 2026 21:22
@ztanner ztanner force-pushed the ztanner/partial-fallback-allowquery branch from ed3bb76 to 82ddf97 Compare March 4, 2026 22:56
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Mar 4, 2026

Tests Passed

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Mar 4, 2026

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 455ms 455ms ▇▁▁▁▁
Cold (Ready in log) 436ms 438ms ▇▁▁▁▁
Cold (First Request) 1.230s 1.250s ▇▃▁▃▁
Warm (Listen) 457ms 456ms ▇▁▁▁▁
Warm (Ready in log) 440ms 440ms ▆▁▁▁▁
Warm (First Request) 346ms 345ms ▆▂▂▁▂
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 455ms ▁▁█▁▁
Cold (Ready in log) 435ms 435ms ▅▆█▁▆
Cold (First Request) 1.848s 1.856s ▄▄█▂▄
Warm (Listen) 456ms 455ms ▁▁█▁▁
Warm (Ready in log) 435ms 435ms ▄▅█▁▄
Warm (First Request) 1.855s 1.868s ▄▄█▁▄

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 3.776s 3.826s ▆▁▃▁▃
Cached Build 3.851s 3.835s ▆▁▃▁▃
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 13.891s 13.860s ▂▂█▁▂
Cached Build 14.000s 14.030s ▁▂█▁▁
node_modules Size 476 MB 476 MB ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **401 kB** → **401 kB** ✅ -14 B

80 files with content-based hashes (individual files not comparable between builds)

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 767 B 764 B
Total 767 B 764 B ✅ -3 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 450 B 452 B
Total 450 B 452 B ⚠️ +2 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.54 kB N/A -
6280-HASH.js gzip 59.4 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.59 kB N/A -
e8aec2e4-HASH.js gzip 62.6 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 256 B 254 B
main-HASH.js gzip 39.1 kB 39.1 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.59 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.55 kB -
6948ada0-HASH.js gzip N/A 62.6 kB -
9544-HASH.js gzip N/A 60.2 kB -
Total 233 kB 234 kB ⚠️ +733 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.51 kB 2.51 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.98 kB 7.98 kB ✅ -1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 254 kB 254 kB
Total 378 kB 379 kB ⚠️ +495 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 619 B 614 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 43.2 kB 43.7 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 44.9 kB 45.3 kB ⚠️ +416 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 715 B 718 B
Total 715 B 718 B ⚠️ +3 B
Build Cache
Canary PR Change
0.pack gzip 4.04 MB 4.04 MB
index.pack gzip 103 kB 101 kB 🟢 1.37 kB (-1%)
index.pack.old gzip 103 kB 102 kB
Total 4.24 MB 4.24 MB ⚠️ +748 B

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 321 kB 321 kB
app-page-exp..prod.js gzip 170 kB 170 kB
app-page-tur...dev.js gzip 321 kB 321 kB
app-page-tur..prod.js gzip 170 kB 170 kB
app-page-tur...dev.js gzip 318 kB 318 kB
app-page-tur..prod.js gzip 168 kB 168 kB
app-page.run...dev.js gzip 318 kB 318 kB
app-page.run..prod.js gzip 168 kB 168 kB
app-route-ex...dev.js gzip 70.3 kB 70.3 kB
app-route-ex..prod.js gzip 48.6 kB 48.6 kB
app-route-tu...dev.js gzip 70.4 kB 70.4 kB
app-route-tu..prod.js gzip 48.7 kB 48.7 kB
app-route-tu...dev.js gzip 69.9 kB 69.9 kB
app-route-tu..prod.js gzip 48.4 kB 48.4 kB
app-route.ru...dev.js gzip 69.9 kB 69.9 kB
app-route.ru..prod.js gzip 48.4 kB 48.4 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 43.2 kB 43.2 kB
pages-api-tu..prod.js gzip 32.9 kB 32.9 kB
pages-api.ru...dev.js gzip 43.2 kB 43.2 kB
pages-api.ru..prod.js gzip 32.9 kB 32.9 kB
pages-turbo....dev.js gzip 52.6 kB 52.6 kB
pages-turbo...prod.js gzip 38.5 kB 38.5 kB
pages.runtim...dev.js gzip 52.6 kB 52.6 kB
pages.runtim..prod.js gzip 38.5 kB 38.5 kB
server.runti..prod.js gzip 61.8 kB 61.8 kB
Total 2.83 MB 2.83 MB ⚠️ +3 B
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/05758b2886e595123e5de6ca9284899dabef3a48/next

@ztanner ztanner force-pushed the ztanner/partial-fallback-allowquery branch from 82ddf97 to 05758b2 Compare March 5, 2026 20:21
Copy link
Member Author

ztanner commented Mar 6, 2026

Merge activity

  • Mar 6, 4:16 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Mar 6, 4:16 PM UTC: @ztanner merged this pull request with Graphite.

@ztanner ztanner merged commit cb54d20 into canary Mar 6, 2026
408 of 417 checks passed
@ztanner ztanner deleted the ztanner/partial-fallback-allowquery branch March 6, 2026 16:16
sokra pushed a commit that referenced this pull request Mar 6, 2026
Analogous change to vercel/vercel#15338, but for the new Next.js adapter API.

This updates only allowQuery for fallback HTML when the route is a true partialFallback (PPR fallback with postponed state) and cache components is enabled. For all other fallback cases, behavior stays the same as today (allowQuery is cleared to [] for shared fallback caching).

This change is needed because partial-fallback shells can be param-specific, so collapsing them to one shared fallback cache key can serve the wrong shell across params and block correct upgrade behavior. Gating this behind partialFallback lets us roll out the new behavior safely and independently, without changing legacy fallback semantics for non-partial paths.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants