React / 系统课时
理解静态与动态渲染
理解静态与动态渲染
判断一个页面该静态还是动态,核心只看一件事:生成结果需要的信息在请求到来之前是否已经确定。本节会把预渲染与请求时渲染放到同一条时间线上,并用两个最小路由说明它们的行为差异和选择边界。
学习目标
- 区分预渲染与请求时动态渲染发生的时机
- 根据数据新鲜度、用户差异和请求上下文选择渲染方式
- 理解现代 App Router 中同一路由可以混合静态与请求时内容
渲染差异本质上是时间点不同
预渲染发生在构建时或重新验证时,得到的结果可以被缓存并复用于后续请求。它适合所有用户看到相同内容、变化频率可控的页面,例如文档、营销页和公开文章。
动态渲染发生在请求到达之后。它适合必须读取当前请求信息,或每次访问都可能产生不同结果的页面,例如依赖 Cookie 的账户页、实时库存、个性化仪表盘。动态并不代表“更高级”,只是把计算成本推迟到了请求阶段。

用两个路由观察差异
下面示例假设项目使用 App Router。/about 只依赖确定性内容,可以参与预渲染;/request-time 调用 connection(),明确要求后续渲染等待真实请求到来。
// app/about/page.tsx
export default function AboutPage() {
return <p>这段内容可以预渲染</p>
}// app/request-time/page.tsx
import { connection } from 'next/server'
export default async function RequestTimePage() {
// 从这里开始依赖真实请求,而不是继续预渲染
await connection()
return <p>请求时间:{new Date().toISOString()}</p>
}预期结果
/about:这段内容可以预渲染
/request-time:请求时间:<TIME><TIME> 会随请求变化。connection() 适用于页面没有读取 cookies()、headers() 等请求时 API,但仍明确需要每次请求再计算的情况;如果已经读取这些请求时数据,通常不需要为了“变动态”再额外调用它。
按数据特征选择
| 判断问题 | 更适合预渲染 | 更适合动态渲染 |
|---|---|---|
| 不同用户看到的内容是否相同 | 通常相同 | 经常不同 |
| 是否必须读取当前请求信息 | 不需要 | 需要 |
| 数据变化能否接受重新验证延迟 | 可以 | 不可以 |
| 是否希望尽量减少请求时计算 | 是 | 不是首要目标 |
公开商品详情并不因为“数据来自数据库”就必须动态,只要内容可以缓存并按策略重新验证,仍然适合预渲染。反过来,即使页面 HTML 很简单,只要结果依赖登录 Cookie、请求头或当前请求才知道的参数,就应把对应部分留到请求时处理。
不要把整页机械分成静态或动态
现代 App Router 可以在一个路由中组合预渲染内容、缓存内容和请求时内容。尤其当项目启用 Cache Components 时,静态壳可以先返回,真正依赖请求的数据再通过 Suspense 边界流式补齐,因此更准确的问题是“哪一部分必须等请求”,而不是“这个页面只能选静态或动态”。
选择渲染方式时先看数据约束,再看性能。能安全复用的内容优先预渲染;只有请求到来后才有答案的内容再动态计算,这样既不会牺牲正确性,也能避免不必要的服务端工作。