渲染策略(App Router)
優先級:P0(關鍵)
根據資料新鮮度與擴展需求選擇渲染策略。請參閱策略矩陣。
實作指南
- SSG(靜態網站生成):App Router 的預設值。使用
generateStaticParams在建置時預渲染路由。由fetch搭配cache: 'force-cache'觸發。 - SSR(伺服器端渲染):由
cookies()、headers()或fetch搭配cache: 'no-store'觸發。用於個人化或高時效性資料。 - ISR(增量靜態再生):在建置後更新靜態內容。使用
revalidate(基於時間)或revalidatePath/revalidateTag(按需觸發)。 - 串流(Streaming):使用
Suspense包裝緩慢的非同步元件,防止它們阻塞頁面初始載入。使用loading.tsx實現路由層級的骨架屏。 - PPR(部分預渲染):在單一 HTTP 請求中結合靜態外殼與動態區域。在
next.config.js中啟用ppr: true。 - 策略:根據 SEO(SSG/ISR)vs 互動性(Client)vs 個人化(SSR)來選擇渲染方式。利用
dynamicParams控制未快取路由的 fallback 行為。 - Hydration:避免在初始渲染中使用僅限瀏覽器的值(
window.innerWidth、Date.now())以避免 Hydration 錯誤。請使用mounteduseEffect 模式。 - 邊緣執行環境:當不需要完整的 Node.js API 時,使用
runtime: 'edge'以實現低延遲的全域分散式執行。
反模式
- 不要在
page.tsx中進行根層級等待:將慢速元件包裝在<Suspense>中以進行串流。 - 不要對靜態內容使用 SSR:使用 SSG 或 ISR;將 SSR 保留給真正動態的資料。
- 不要在初始渲染中使用
typeof window:使用useEffect來避免 hydration 錯誤。