キャッシュコンポーネント(Next.js 16+)
キャッシュコンポーネントは、Partial Prerendering (PPR) を実現します。単一のルート内で静的、キャッシュ済み、動的なコンテンツを混在させることができます。
キャッシュコンポーネントの有効化
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
}
export default nextConfig
これは古い experimental.ppr フラグを置き換えます。
3つのコンテンツタイプ
キャッシュコンポーネントを有効にすると、コンテンツは次の3つのカテゴリに分類されます。
1. 静的(自動プリレンダリング)
同期コード、インポート、純粋な計算 — ビルド時にプリレンダリングされます。
export default function Page() {
return (
<header>
<h1>われわれのブログ</h1> {/* 静的 - 即座に表示 */}
<nav>...</nav>
</header>
)
}
2. キャッシュ済み(use cache)
リクエストごとに新しいフェッチを必要としない非同期データ。
async function BlogPosts() {
'use cache'
cacheLife('hours')
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
3. 動的(Suspense)
常に最新である必要があるランタイムデータ — Suspense でラップします。
import { Suspense } from 'react'
export default function Page() {
return (
<>
<BlogPosts /> {/* キャッシュ済み */}
<Suspense fallback={<p>読み込み中...</p>}>
<UserPreferences /> {/* 動的 - ストリーミング */}
</Suspense>
</>
)
}
async function UserPreferences() {
const theme = (await cookies()).get('theme')?.value
return <p>テーマ: {theme}</p>
}
use cache ディレクティブ
ファイルレベル
'use cache'
export default async function Page() {
// ページ全体がキャッシュされる
const data = await fetchData()
return <div>{data}</div>
}
コンポーネントレベル
export async function CachedComponent() {
'use cache'
const data = await fetchData()
return <div>{data}</div>
}
関数レベル
export async function getData() {
'use cache'
return db.query('SELECT * FROM posts')
}
キャッシュプロファイル
組み込みプロファイル
'use cache' // デフォルト: 5分 stale、15分 revalidate
'use cache: remote' // プラットフォーム提供のキャッシュ (Redis, KV)
'use cache: private' // コンプライアンス用、ランタイムAPI許可
cacheLife() - カスタム有効期間
import { cacheLife } from 'next/cache'
async function getData() {
'use cache'
cacheLife('hours') // 組み込みプロファイル
return fetch('/api/data')
}
組み込みプロファイル: 'default', 'minutes', 'hours', 'days', 'weeks', 'max'
インライン設定
async function getData() {
'use cache'
cacheLife({
stale: 3600, // 1時間 - stale のまま再検証中も配信
revalidate: 7200, // 2時間 - バックグラウンド再検証間隔
expire: 86400, // 1日 - ハード期限
})
return fetch('/api/data')
}
キャッシュの無効化
cacheTag() - キャッシュコンテンツへのタグ付け
import { cacheTag } from 'next/cache'
async function getProducts() {
'use cache'
cacheTag('products')
return db.products.findMany()
}
async function getProduct(id: string) {
'use cache'
cacheTag('products', `product-${id}`)
return db.products.findUnique({ where: { id } })
}
updateTag() - 即時無効化
同一リクエスト内でキャッシュを即座に更新したい場合に使用します。
'use server'
import { updateTag } from 'next/cache'
export async function updateProduct(id: string, data: FormData) {
await db.products.update({ where: { id }, data })
updateTag(`product-${id}`) // 即時 - 同じリクエストで新しいデータを参照
}
revalidateTag() - バックグラウンド再検証
stale-while-revalidate の動作が必要な場合に使用します。
'use server'
import { revalidateTag } from 'next/cache'
export async function createPost(data: FormData) {
await db.posts.create({ data })
revalidateTag('posts') // バックグラウンド - 次のリクエストで新しいデータ
}
ランタイムデータの制約
use cache 内では cookies()、headers()、searchParams にアクセスできません。
解決策: 引数として渡す
// 間違い - use cache 内でランタイムAPIを使用
async function CachedProfile() {
'use cache'
const session = (await cookies()).get('session')?.value // エラー!
return <div>{session}</div>
}
// 正しい - 外で取り出し、引数として渡す
async function ProfilePage() {
const session = (await cookies()).get('session')?.value
return <CachedProfile sessionId={session} />
}
async function CachedProfile({ sessionId }: { sessionId: string }) {
'use cache'
// sessionId は自動的にキャッシュキーの一部になる
const data = await fetchUserData(sessionId)
return <div>{data.name}</div>
}
例外: use cache: private
リファクタリングできない場合のコンプライアンス要件向け。
async function getData() {
'use cache: private'
const session = (await cookies()).get('session')?.value // 許可
return fetchData(session)
}
キャッシュキーの生成
キャッシュキーは以下に基づいて自動生成されます。
- ビルドID - デプロイ時にすべてのキャッシュを無効化
- 関数ID - 関数の場所を示すハッシュ
- シリアライズ可能な引数 - props がキーの一部になる
- クロージャ変数 - 外側のスコープの値が含まれる
async function Component({ userId }: { userId: string }) {
const getData = async (filter: string) => {
'use cache'
// キャッシュキー = userId (クロージャ) + filter (引数)
return fetch(`/api/users/${userId}?filter=${filter}`)
}
return getData('active')
}
完全な例
import { Suspense } from 'react'
import { cookies } from 'next/headers'
import { cacheLife, cacheTag } from 'next/cache'
export default function DashboardPage() {
return (
<>
{/* 静的シェル - CDNから即座 */}
<header><h1>ダッシュボード</h1></header>
<nav>...</nav>
{/* キャッシュ済み - 高速、1時間ごとに再検証 */}
<Stats />
{/* 動的 - 新しいデータでストリーミング */}
<Suspense fallback={<NotificationsSkeleton />}>
<Notifications />
</Suspense>
</>
)
}
async function Stats() {
'use cache'
cacheLife('hours')
cacheTag('dashboard-stats')
const stats = await db.stats.aggregate()
return <StatsDisplay stats={stats} />
}
async function Notifications() {
const userId = (await cookies()).get('userId')?.value
const notifications = await db.notifications.findMany({
where: { userId, read: false }
})
return <NotificationList items={notifications} />
}
以前のバージョンからの移行
| 古い設定 | 置き換え |
|---|---|
experimental.ppr | cacheComponents: true |
dynamic = 'force-dynamic' | 削除(デフォルト動作) |
dynamic = 'force-static' | 'use cache' + cacheLife('max') |
revalidate = N | cacheLife({ revalidate: N }) |
unstable_cache() | 'use cache' ディレクティブ |
制限事項
- Edge ランタイムは非対応 - Node.js が必要
- 静的エクスポートは非対応 - サーバーが必要
- 非決定論的な値 (
Math.random(),Date.now()) はuse cache内でビルド時に1回だけ実行される
キャッシュ外でリクエスト時にランダム性が必要な場合:
import { connection } from 'next/server'
async function DynamicContent() {
await connection() // リクエスト時に遅延
const id = crypto.randomUUID() // リクエストごとに異なる
return <div>{id}</div>
}
ソース: