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。
export const dynamic = 'force-dynamic'
export default async function MonitorPage() {
// 时间值在服务器执行页面时生成,用来观察是否发生了新的请求时渲染。
const renderedAt = new Date().toISOString()
return (
<main>
<h1>实时监控</h1>
<p>服务器渲染时间:{renderedAt}</p>
</main>
)
}预期结果
首次访问:服务器渲染时间:<TIME>
刷新页面:服务器渲染时间:<TIME>两次 <TIME> 应不同,实际时间值取决于请求发生时刻。若把配置改成 force-static 并在生产模式重新构建,页面会复用预渲染结果,而不是每次刷新都产生新的服务器渲染时间。
在生产模式验证
开发模式会为了开发体验改变缓存与渲染表现,因此不要只靠 npm run dev 判断静态或动态。先构建,再启动生产服务器。
npm run build && npm start预期输出
▲ Next.js <VERSION>
- Local: http://localhost:<PORT>
✓ Ready in <TIME><VERSION>、<PORT> 和 <TIME> 会随环境变化。启动后访问 /monitor 并连续刷新;当前示例使用 force-dynamic,服务器渲染时间应随请求变化。
不要把实时性和动态渲染画等号
如果数据只是“偶尔变化”,直接使用动态渲染通常会付出不必要的计算与数据源访问成本。公开内容更适合先静态化,再通过时间重新验证或事件触发失效更新缓存;真正依赖 Cookie、Header、权限、搜索条件或秒级新鲜度的数据,才更适合请求时渲染。
实际项目中,先保持 auto,再根据“是否依赖当前请求”和“允许旧数据存在多久”缩小到静态、动态或静态加重新验证,通常比一开始就全站强制动态更稳妥。