レンダリング戦略(App Router)
優先度: P0 (クリティカル)
データの鮮度とスケーリングのニーズに基づいてレンダリング戦略を選択します。戦略マトリックスを参照してください。
実装ガイドライン
- SSG(静的サイト生成): App Routerのデフォルトです。
generateStaticParamsを使用して、ビルド時にルートを事前レンダリングします。fetchとcache: 'force-cache'によってトリガーされます。 - SSR(サーバーサイドレンダリング):
cookies()、headers()、またはcache: 'no-store'を指定したfetchによってトリガーされます。パーソナライズされたデータや鮮度の高いデータに使用します。 - ISR(インクリメンタル静的再生成): ビルド後に静的コンテンツを更新します。
revalidate(時間ベース)またはrevalidatePath/revalidateTag(オンデマンド)を使用します。 - ストリーミング:
Suspenseを使用して遅い非同期コンポーネントをラップし、初期ページ読み込みをブロックしないようにします。ルートレベルのスケルトンにはloading.tsxを使用します。 - PPR(部分プリレンダリング): 単一のHTTPリクエストで静的シェルと動的領域を組み合わせます。
next.config.jsでppr: trueを有効にします。 - 戦略: SEO(SSG/ISR) vs インタラクティブ性(クライアント) vs パーソナライゼーション(SSR)に基づいてレンダリングを選択します。
dynamicParamsを使用して、キャッシュされていないルートのフォールバック動作を制御します。 - ハイドレーション: 初期レンダリングでブラウザのみの値(
window.innerWidth、Date.now())を使用しないことで、ハイドレーションエラーを回避します。mounteduseEffectパターンを使用します。 - エッジランタイム: 完全なNode.js APIが不要で、低レイテンシでグローバルに分散された実行が必要な場合は、
runtime: 'edge'を使用します。
アンチパターン
page.tsxでのルートレベルのawaitは禁止: 遅いコンポーネントは<Suspense>でラップしてストリーミングします。- 静的コンテンツにSSRは禁止: SSGまたはISRを使用し、SSRは真に動的なデータのために予約します。
- 初期レンダリングでの
typeof windowの使用は禁止:useEffectを使用してハイドレーションエラーを回避します。