RRSC Lab

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 吐出即刻送达浏览器。