渲染策略(应用路由器)
优先级:P0(关键)
根据数据新鲜度和扩展需求选择渲染策略。请参阅策略矩阵。
实现指南
- SSG(静态站点生成):应用路由器的默认策略。使用
generateStaticParams在构建时预渲染路由。通过fetch配合cache: 'force-cache'触发。 - SSR(服务端渲染):通过
cookies()、headers()或fetch配合cache: 'no-store'触发。适用于个性化或高新鲜度数据场景。 - ISR(增量静态再生成):在构建后更新静态内容。使用
revalidate(基于时间)或revalidatePath/revalidateTag(按需触发)。 - 流式渲染:使用
Suspense包裹慢速异步组件,防止它们阻塞首屏加载。使用loading.tsx实现路由级别的骨架屏。 - PPR(部分预渲染):在单个 HTTP 请求中组合静态外壳和动态区域。在
next.config.js中启用ppr: true。 - 策略选择:根据 SEO(SSG/ISR)与 交互性(客户端)与 个性化(SSR)进行选择。利用
dynamicParams控制未缓存路由的回退行为。 - 水合:避免在初始渲染中使用仅浏览器端可用的值(如
window.innerWidth、Date.now())导致水合错误。请使用mounted的useEffect模式。 - Edge 运行时:使用
runtime: 'edge'实现低延迟的全局分布式执行,适用于不需要完整 Node.js API 的场景。
反模式
- 不要在
page.tsx中根层级await:将慢速组件包裹在<Suspense>中以实现流式渲染。 - 不要为静态内容使用 SSR:使用 SSG 或 ISR;SSR 仅用于真正动态的数据。
- 不要在初始渲染中使用
typeof window:使用useEffect避免水合错误。