React / 系统课时

理解静态与动态渲染

理解静态与动态渲染

判断一个页面该静态还是动态,核心只看一件事:生成结果需要的信息在请求到来之前是否已经确定。本节会把预渲染与请求时渲染放到同一条时间线上,并用两个最小路由说明它们的行为差异和选择边界。

学习目标

  • 区分预渲染与请求时动态渲染发生的时机
  • 根据数据新鲜度、用户差异和请求上下文选择渲染方式
  • 理解现代 App Router 中同一路由可以混合静态与请求时内容

渲染差异本质上是时间点不同

预渲染发生在构建时或重新验证时,得到的结果可以被缓存并复用于后续请求。它适合所有用户看到相同内容、变化频率可控的页面,例如文档、营销页和公开文章。

动态渲染发生在请求到达之后。它适合必须读取当前请求信息,或每次访问都可能产生不同结果的页面,例如依赖 Cookie 的账户页、实时库存、个性化仪表盘。动态并不代表“更高级”,只是把计算成本推迟到了请求阶段。

静态与动态渲染时间线对比

用两个路由观察差异

下面示例假设项目使用 App Router。/about 只依赖确定性内容,可以参与预渲染;/request-time 调用 connection(),明确要求后续渲染等待真实请求到来。

tsx
// app/about/page.tsx
export default function AboutPage() {
  return <p>这段内容可以预渲染</p>
}
tsx
// app/request-time/page.tsx
import { connection } from 'next/server'

export default async function RequestTimePage() {
  // 从这里开始依赖真实请求,而不是继续预渲染
  await connection()

  return <p>请求时间:{new Date().toISOString()}</p>
}

预期结果

text
/about:这段内容可以预渲染
/request-time:请求时间:<TIME>

<TIME> 会随请求变化。connection() 适用于页面没有读取 cookies()、headers() 等请求时 API,但仍明确需要每次请求再计算的情况;如果已经读取这些请求时数据,通常不需要为了“变动态”再额外调用它。

按数据特征选择

判断问题 更适合预渲染 更适合动态渲染
不同用户看到的内容是否相同 通常相同 经常不同
是否必须读取当前请求信息 不需要 需要
数据变化能否接受重新验证延迟 可以 不可以
是否希望尽量减少请求时计算 是 不是首要目标

公开商品详情并不因为“数据来自数据库”就必须动态,只要内容可以缓存并按策略重新验证,仍然适合预渲染。反过来,即使页面 HTML 很简单,只要结果依赖登录 Cookie、请求头或当前请求才知道的参数,就应把对应部分留到请求时处理。

不要把整页机械分成静态或动态

现代 App Router 可以在一个路由中组合预渲染内容、缓存内容和请求时内容。尤其当项目启用 Cache Components 时,静态壳可以先返回,真正依赖请求的数据再通过 Suspense 边界流式补齐,因此更准确的问题是“哪一部分必须等请求”,而不是“这个页面只能选静态或动态”。

选择渲染方式时先看数据约束,再看性能。能安全复用的内容优先预渲染;只有请求到来后才有答案的内容再动态计算,这样既不会牺牲正确性,也能避免不必要的服务端工作。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解静态与动态渲染

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

登录哪都通