NNext.js 中文网 GitHub

Next.js 渲染理念

了解 Next.js 如何在组件级别将静态和动态渲染视为一个连续谱,以及这对部署意味着什么。

静态与动态作为一个连续谱#

大多数 Web 框架在路由级别对静态和动态划分了明确的界限。页面要么在构建时预渲染,要么在请求时服务器端渲染。这种模型易于理解也易于部署:你将静态文件上传到 CDN,并将动态路由指向服务器。

Next.js 采用了不同的方法:静态和动态之间的界限在组件级别,而不是路由级别。 单个页面可以有一个即时加载的静态外壳,以及随着解析而流式传入的动态部分。缓存的函数可以位于动态路由内。静态页面无需重新部署即可更新。

这正是 Partial Prerendering、Cache Components(use cache)和按需重新验证所实现的。它们不是渐进式功能:它们代表了一种将静态和动态视为连续谱而非二元选择的渲染模型。

这带来了什么#

这种模型以具体的方式使开发者和用户受益:

  • 更快的感知加载速度。 静态外壳立即渲染,而动态内容流式传入。用户立即看到有用的内容,而不必等待整个页面渲染完成。
  • 增量缓存。 开发者可以增量地添加缓存和重新验证,而无需在构建时预先决定路由是静态还是动态。任何页面都可以按需重新验证,任何函数都可以用 use cache 进行缓存。
  • 细粒度缓存。 用 use cache 缓存一个函数,而不是缓存整个路由。重新验证一个标签,而不是一次部署。这意味着开销较大的数据库查询可以独立于页面其余部分进行缓存。

权衡#

Web 框架在静态和动态内容之间放置边界的位置上各不相同。每种方法都在开发者的灵活性和基础设施的复杂性之间做出不同的权衡。

构建时预渲染#

每个页面都在构建时生成。输出的是静态文件,可以从任何 CDN 或文件服务器提供,无需任何运行时基础设施。动态内容(如果有)需要在页面加载后进行客户端获取。这是最容易部署的模型,但每次内容更改都需要重新构建和重新部署。

路由级边界#

每个路由选择自己是静态还是动态。静态路由在构建时预渲染,动态路由按请求进行服务器端渲染。基础设施清晰分离:静态文件放到 CDN,动态路由放到服务器。这易于推理,但每个路由的选择是全有或全无。一个大部分为静态但包含一个动态元素(用户问候语、实时价格)的页面,必须要么完全动态,要么在加载后从客户端获取该元素。

组件级边界#

这是 Next.js 采用的方法。静态和动态内容在同一个流式响应中共存。一个页面可以有一个即时加载的静态外壳、一个独立重新验证的缓存函数,以及一个随解析而流式传入的动态部分,而开发者无需将任何内容拆分为单独的路由或客户端获取。

代价是基础设施的复杂性。更细粒度的渲染边界将复杂性从应用代码转移到托管平台。下面描述的基础设施要求正是由于这一选择而产生的。

对基础设施的影响#

组件级渲染模型对托管 Next.js 应用的平台有直接影响:

  • 流式渲染(Streaming)是必需的,因为静态和动态内容在同一个响应中提供。服务器先发送初始内容,然后在动态部分解析时将其流式传输。详情请参阅流式渲染。
  • 运行多个实例时需要缓存协调,因为任何缓存内容都可以通过 revalidateTag() 或 revalidatePath() 按需失效。有关架构请参阅重新验证的工作原理。
  • 缓存一致性很重要,因为重新验证会同时重新生成 HTML 响应和 RSC payload(用于客户端导航的序列化 React Server Components 数据)。如果两者不同步,用户可能在导航期间看到不一致的数据。有关一致性要求请参阅重新验证的工作原理。
  • 以 CDN 延迟交付 PPR 外壳可能需要额外的平台集成,以单独存储静态外壳并正确恢复动态渲染。有关实现细节请参阅 PPR 平台指南。

每一项基础设施要求都直接对应一种能力:流式渲染实现渐进式交付,缓存协调在实例间传播失效操作,缓存一致性保持 HTML 和 RSC 对齐,而边缘 PPR 通常需要额外的外壳/恢复集成。

可移植性与保真度#

Next.js 作为 Node.js 服务器进程运行,单个进程即可正确处理每一项功能。流式渲染支持使 Server Components 和 PPR 能够渐进式交付;没有它,响应会被缓冲,但功能仍然可用。额外的基础设施投入(CDN 缓存、边缘计算、共享缓存)可以提升性能,并在多实例部署中减少一致性差距。

为了更具体地说明,我们区分两种类型的平台支持:

功能保真度(Functional fidelity)意味着每一项 Next.js 功能都能在平台上正确工作。适配器测试套件就是契约:如果某个平台的适配器通过了测试,它就具备完整的功能保真度。这是二元的:要么通过,要么不通过。该测试套件欢迎平台合作伙伴贡献,以确保其公平和完整。

性能保真度(Performance fidelity)意味着功能达到其最佳性能特征。例如,PPR 的静态外壳以 CDN 延迟而非源站延迟提供,或者 ISR 立即提供陈旧内容同时在后台重新验证并实现亚秒级传播。性能保真度是一个连续谱:每个平台根据其架构达到不同水平,并且平台会随时间不断改进。

达到功能保真度的平台就是 Next.js 完全支持的部署目标。性能保真度是平台之间差异化之处。有关完整的功能兼容性矩阵,请参阅部署到平台。

CDN 功能兼容性#

许多 CDN 都提供有用的原语,可用于与 Next.js 进行更深入的集成(边缘计算、键值对存储、blob 存储),但端到端的 PPR 恢复支持仍在发展中,可能需要定制化的平台工作。如今大多数社区适配器将 Next.js 部署为 Node.js 服务器,并未利用这些 CDN 特有的原语。有关当前的适配器列表,请参阅部署页面。

有关完整的 CDN 兼容性表格,请参阅部署到平台;有关缓存行为的详细信息,请参阅 CDN 缓存。

Next.js 中文网