Skip to content

Conversation

@andrewimm
Copy link
Contributor

@andrewimm andrewimm commented Jan 9, 2026

Custom Cache-Control headers on /_next/ routes can cause hard-to-debug development behaviors. Normally the dev server sends no-cache values to ensure that assets are always fresh. If a developer sets the max-age or immutable flag,, the browser can cache resources between requests, even if the source changes.

Adding a warning will at least make this problem easier to debug.

@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. type: next labels Jan 9, 2026
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 9, 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) 439ms 440ms ▇█▇█▁
Cold (First Request) 1.174s 1.167s █▇██▁
Warm (Listen) 456ms 456ms ▁▁▁▁▁
Warm (Ready in log) 449ms 442ms ▁▁▁▂▁
Warm (First Request) 346ms 340ms ▂▂▂▆▄
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 455ms 456ms █▅▁▁▁
Cold (Ready in log) 443ms 442ms ▄▆▇█▆
Cold (First Request) 1.850s 1.842s ▅▅▆▅▄
Warm (Listen) 456ms 456ms █████
Warm (Ready in log) 442ms 458ms ▄██▇█
Warm (First Request) 1.840s 1.900s ▅▅▇▅▅

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.100s 4.056s ▂▁▁▁▂
Cached Build 4.094s 4.036s ▂▁▁▂▂
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 13.829s 13.966s ▆▁▃▁▁
Cached Build 14.282s 14.308s ▆▁▃▁▁
node_modules Size 458 MB 458 MB █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **431 kB** → **431 kB** ✅ -16 B

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

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 787 B 791 B
Total 787 B 791 B ⚠️ +4 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 451 B 450 B
Total 451 B 450 B ✅ -1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
2086.HASH.js gzip 169 B N/A -
2161-HASH.js gzip 5.41 kB N/A -
2747-HASH.js gzip 4.48 kB N/A -
4322-HASH.js gzip 52.8 kB N/A -
ec793fe8-HASH.js gzip 62.3 kB N/A -
framework-HASH.js gzip 59.8 kB 59.8 kB
main-app-HASH.js gzip 251 B 254 B 🔴 +3 B (+1%)
main-HASH.js gzip 38.6 kB 39 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
1596.HASH.js gzip N/A 169 B -
2658-HASH.js gzip N/A 52.7 kB -
6349-HASH.js gzip N/A 4.46 kB -
7019-HASH.js gzip N/A 5.43 kB -
b17a3386-HASH.js gzip N/A 62.3 kB -
Total 225 kB 226 kB ⚠️ +245 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 193 B
_error-HASH.js gzip 182 B 182 B
css-HASH.js gzip 336 B 335 B
dynamic-HASH.js gzip 1.8 kB 1.8 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 352 B 349 B
hooks-HASH.js gzip 385 B 384 B
image-HASH.js gzip 580 B 580 B
index-HASH.js gzip 259 B 258 B
link-HASH.js gzip 2.5 kB 2.51 kB
routerDirect..HASH.js gzip 319 B 317 B
script-HASH.js gzip 385 B 387 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.96 kB ✅ -8 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 242 kB 242 kB
Total 367 kB 367 kB ⚠️ +495 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 655 B 653 B
middleware-r..fest.js gzip 155 B 156 B
middleware.js gzip 33 kB 33.3 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 34.6 kB 34.9 kB ⚠️ +319 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 738 B 738 B
Total 738 B 738 B
Build Cache
Canary PR Change
0.pack gzip 3.67 MB 3.67 MB 🔴 +5.13 kB (+0%)
index.pack gzip 100 kB 100 kB
index.pack.old gzip 100 kB 101 kB
Total 3.87 MB 3.87 MB ⚠️ +5.35 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 304 kB 304 kB
app-page-exp..prod.js gzip 158 kB 158 kB
app-page-tur...dev.js gzip 304 kB 304 kB
app-page-tur..prod.js gzip 158 kB 158 kB
app-page-tur...dev.js gzip 300 kB 300 kB
app-page-tur..prod.js gzip 156 kB 156 kB
app-page.run...dev.js gzip 301 kB 301 kB
app-page.run..prod.js gzip 156 kB 156 kB
app-route-ex...dev.js gzip 68.8 kB 68.8 kB
app-route-ex..prod.js gzip 47.6 kB 47.6 kB
app-route-tu...dev.js gzip 68.8 kB 68.8 kB
app-route-tu..prod.js gzip 47.6 kB 47.6 kB
app-route-tu...dev.js gzip 68.4 kB 68.4 kB
app-route-tu..prod.js gzip 47.4 kB 47.4 kB
app-route.ru...dev.js gzip 68.4 kB 68.4 kB
app-route.ru..prod.js gzip 47.3 kB 47.3 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 41.2 kB 41.2 kB
pages-api-tu..prod.js gzip 31.3 kB 31.3 kB
pages-api.ru...dev.js gzip 41.1 kB 41.1 kB
pages-api.ru..prod.js gzip 31.2 kB 31.2 kB
pages-turbo....dev.js gzip 50.9 kB 50.9 kB
pages-turbo...prod.js gzip 38.3 kB 38.3 kB
pages.runtim...dev.js gzip 50.8 kB 50.8 kB
pages.runtim..prod.js gzip 38.3 kB 38.3 kB
server.runti..prod.js gzip 62.3 kB 62.3 kB
Total 2.69 MB 2.69 MB ✅ -1 B

@andrewimm andrewimm force-pushed the andrewimm/cache-control-warn branch from d0f4df7 to 8fabeab Compare January 9, 2026 23:51
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 10, 2026

Tests Passed

@asdiamond
Copy link

@Patticatti

Custom `Cache-Control` headers on `/_next/` routes can cause hard-to-debug
development behaviors. Normally the dev server sends no-cache values to
ensure that assets are always fresh. If a developer sets the max-age or
the immutable flag, the browser can cache resources between requests,
even if the source changes.

Adding a warning will at least make this problem easier to debug.
@andrewimm andrewimm force-pushed the andrewimm/cache-control-warn branch from 8fabeab to 24ec77c Compare January 12, 2026 18:12
@andrewimm andrewimm merged commit 818be9a into canary Jan 12, 2026
161 checks passed
@andrewimm andrewimm deleted the andrewimm/cache-control-warn branch January 12, 2026 19:02
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.

5 participants