Next.js 16 Cache Components · Interactive Architecture Lab
RSC 架构与缓存实验台
在这里直观对照「构建/缓存快照(use cache)」与「请求期动态渲染(connection())」,并可按需触发 updateTag、局部流式探针、404 与 ErrorBoundary。
Static / Cached Shell · use cache
缓存快照对照组
- 缓存生成时刻
- 2026-11-19T15:11:13.413Z
- 随机令牌(命中时不变)
- y91b2jgv
- 缓存策略
- cacheLife('hours') · tag: lab-snapshot
- 生成进程 PID
- 1
Isolated Streaming Probe · Suspense
独立流式探针(仅阻塞下方小卡片)
App Router File Conventions
路由边界与容错演练
测试 Next.js 约定文件在实际运行时的表现:错误边界可原地恢复,404 边界可由动态路由主动触发。
工程架构剖析(点击展开细节)
1. 关键 CSS 两遍构建与 experimental.inlineCss 如何避免 cacheComponents 整页推迟
在 Next.js 16 cacheComponents: true 下,若直接在 React 树内渲染手写 <style> 或 <link>,会导致整页退化为 loading.tsx 骨架洞。
本项目通过 prepare-css.mjs --from-build 从全部预渲染外壳 HTML 提取精准样式到 critical.generated.css,由 layout.tsx 通过框架原生 CSS 通道导入并由 inlineCss 内联;全量样式则由 AsyncStyles 在客户端水合后按需注入。
2. proxy.ts 请求边界与 Server Actions 速率限制
Next.js 16 使用根目录 proxy.ts 取代传统 middleware.ts,为每个响应注入 x-rsc-lab: next16 标识,并对携带 next-action 请求头的 POST 实施每 IP 每分钟 10 次的滑窗限流。
3. Caddy HTTP/3 + flush_interval -1 无缓冲流式直出
宿主机 Caddy 监听 443 TCP/UDP(启用 h1 / h2 / h3),反向代理至本容器 127.0.0.1:3000 时设置 flush_interval -1,确保每个 Suspense 分块一旦由 Node.js 吐出即刻送达浏览器。