キャッシュアーキテクチャ
優先度: P1 (高)
Next.js には4つの個別のキャッシュ層があります。これらを理解することで、古いデータによるバグを防ぐことができます。
実装ガイドライン
- Next.js 15+ 標準: API 呼び出しには
fetchとrevalidate: numberまたはcache: 'force-cache'を使用します。カスタムデータストアにはunstable_cacheまたは新しい'use cache'(実験的) を使用します。 - 層の区別: データキャッシュ (リクエスト間で永続的) と リクエストメモ化 (Reactのライフサイクル固有) を区別します。React の
cache()を使用して、単一レンダリング内のフェッチを重複排除します。 - 無効化: ミューテーション後には
revalidatePath('/')を使用し、より細かいキャッシュパージにはrevalidateTag('tag-name')を使用します。 - クライアントキャッシュ: ルーターキャッシュ (クライアント上のインメモリ) とその30秒~分単位の有効期限を理解します。
router.refresh()を使用してクリアします。 - 静的アセット: ビルド時に静的ルートをプリレンダリングするために
generateStaticParamsを活用します。定期的に更新されるコンテンツには ISR (インクリメンタル静的再生成) を使用します。 - ストリーミング:
Suspenseとfetchトリガーを組み合わせて、遅いデータがページ全体のレンダリングをブロックするのを防ぎます。 - Next.js 16+: 利用可能な場合は、
revalidate: numberよりも決定論的なキャッシングのために'use cache'とcacheLife()を優先します。
| 層 | 場所 | 制御 |
|---|---|---|
| リクエストメモ化 | サーバー | React cache() |
| データキャッシュ | サーバー | 'use cache', revalidateTag |
| フルルートキャッシュ | サーバー | 静的プリレンダリング |
| ルーターキャッシュ | クライアント | router.refresh() |
実装詳細
キー生成、クロージャの制約、無効化戦略の詳細については、キャッシュコンポーネントとPPR を参照してください。
アンチパターン
- Next.js 16+ で
unstable_cacheは使用しない: 代わりに'use cache'ディレクティブとcacheLife()を使用します。 - サーバーデータに
router.refresh()は使用しない: 対象を絞ったキャッシュ破棄にはrevalidateTag()を優先します。 - ルートレベルでユーザー固有のデータをキャッシュしない: 個人データは
'use cache'を使用して<Suspense>でラップします。 - タグなしの長期キャッシュは避ける: きめ細かい無効化制御のために
cacheTag()を割り当てます。