React / 系统课时

控制页面动态性

控制页面动态性

同一个 Next.js 页面既可以尽量复用预渲染结果,也可以在每次请求时重新执行服务端渲染。关键不是“哪个更高级”,而是先判断数据是否依赖当前请求、是否必须秒级新鲜,再选择静态、动态或后续的重新验证策略。

学习目标

  • 区分静态渲染与动态渲染的执行时机和适用场景
  • 使用 App Router 的路由段配置明确控制页面动态性
  • 在生产模式下验证页面是否按预期重新渲染

先按数据性质决定渲染方式

静态渲染会在构建阶段或重新验证阶段生成可复用结果,后续请求优先复用缓存;动态渲染则在请求到来时执行页面,因此能读取与当前请求相关的数据。两者都可以发生在服务器端,不要把“动态渲染”误解成“必须在浏览器里渲染”。

场景 更合适的选择 原因
文档、营销页、公开商品介绍 静态 内容变化少,复用结果能降低响应时间和服务器开销
登录后仪表盘、按 Cookie 展示的内容 动态 输出依赖当前用户或当前请求
秒级库存、实时监控 动态 不能接受缓存窗口带来的旧数据
每几分钟更新的资讯列表 静态加重新验证 不必每次请求都重算,又能周期性更新

静态渲染与动态渲染的执行时机对比

用路由段配置明确动态性

以下写法适用于 App Router 且项目没有启用 cacheComponents: true 的缓存模型。dynamic 默认是 auto,让 Next.js 根据请求时 API 和数据获取方式决定渲染行为;只有当业务需要明确保证“每次请求都重新执行”或“必须静态”时,才建议强制配置。

常用值中,force-dynamic 强制请求时渲染;force-static 强制预渲染并缓存;error 用于要求页面保持可静态化,一旦出现不兼容的动态访问就报错。共享布局通常保持 auto,把强制策略放到真正需要的子页面,避免扩大影响范围。

下面把监控页明确设为动态页面。片段示例依赖一个已有的 Next.js App Router 项目,文件路径为 app/monitor/page.tsx。

tsx
export const dynamic = 'force-dynamic'

export default async function MonitorPage() {
  // 时间值在服务器执行页面时生成,用来观察是否发生了新的请求时渲染。
  const renderedAt = new Date().toISOString()

  return (
    <main>
      <h1>实时监控</h1>
      <p>服务器渲染时间:{renderedAt}</p>
    </main>
  )
}

预期结果

text
首次访问:服务器渲染时间:<TIME>
刷新页面:服务器渲染时间:<TIME>

两次 <TIME> 应不同,实际时间值取决于请求发生时刻。若把配置改成 force-static 并在生产模式重新构建,页面会复用预渲染结果,而不是每次刷新都产生新的服务器渲染时间。

在生产模式验证

开发模式会为了开发体验改变缓存与渲染表现,因此不要只靠 npm run dev 判断静态或动态。先构建,再启动生产服务器。

bash
npm run build && npm start

预期输出

text
▲ Next.js <VERSION>
- Local: http://localhost:<PORT>
✓ Ready in <TIME>

<VERSION>、<PORT> 和 <TIME> 会随环境变化。启动后访问 /monitor 并连续刷新;当前示例使用 force-dynamic,服务器渲染时间应随请求变化。

不要把实时性和动态渲染画等号

如果数据只是“偶尔变化”,直接使用动态渲染通常会付出不必要的计算与数据源访问成本。公开内容更适合先静态化,再通过时间重新验证或事件触发失效更新缓存;真正依赖 Cookie、Header、权限、搜索条件或秒级新鲜度的数据,才更适合请求时渲染。

实际项目中,先保持 auto,再根据“是否依赖当前请求”和“允许旧数据存在多久”缩小到静态、动态或静态加重新验证,通常比一开始就全站强制动态更稳妥。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制页面动态性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通