Next.js 15 でのキャッシュ: デフォルトのキャッシュ、revalidateTag、unstable_cache を使用しないフェッチ
15 に移行したときの変更点
Next.js 14 では、サーバーコンポーネントの fetch がデフォルトでキャッシュされていました。 15 では、この動作は逆転されました。
fetchは、明示的にcache: 'force-cache'またはnext.revalidateを指定しない限りキャッシュされません。- ルート ハンドラーの GET ハンドラーは、デフォルトではキャッシュされません。
- ページのクライアントルーターキャッシュは 30 秒のセグメントを保持しなくなりました: 動的ページの
staleTimeはゼロです。
更新後の典型的な話: すべてのページ リクエストがデータを取得するようになったため、API またはデータベースの負荷が増加しました。またはその逆: データはキャッシュされていないように見えますが、ページには古いデータが表示されたままです。
トラップ: フェッチ キャッシュはありませんが、ページは静的です
ルートが動的 API (cookies()、headers()、searchParams、connection()) を使用しない場合、Next.js は next build で事前レンダリングします。キャッシュされていない fetch はビルド時に 1 回実行され、結果は HTML に永久に残ります。開発モードではすべてが動的に見えるため、問題は運用環境でのみ発生します。
チェック - 出力 next build: ○ は静的ルートを意味し、ƒ は動的ルートを意味します。
ルートを明示的に動的にします。
// app/dashboard/page.tsx
import { connection } from "next/server";
export default async function Page() {
await connection(); // дальше всё выполняется на каждый запрос
const stats = await fetch("https://api.example.com/stats").then((r) => r.json());
return <Stats data={stats} />;
}またはその逆に、ページ ファイル内の export const revalidate = 300 を介して静的ルートを定期的に更新します。
タグ付きのフェッチのキャッシュ
// lib/data/posts.ts
export async function getPosts() {
const res = await fetch("https://cms.example.com/posts", {
next: { revalidate: 3600, tags: ["posts"] },
});
if (!res.ok) throw new Error(`cms ${res.status}`);
return res.json() as Promise<Post[]>;
}
export async function getPost(slug: string) {
const res = await fetch(`https://cms.example.com/posts/${slug}`, {
next: { revalidate: 3600, tags: ["posts", `post:${slug}`] },
});
if (res.status === 404) return null;
return res.json() as Promise<Post>;
}revalidate: 3600 - 予備の寿命。主な仕組みは、データ変更時のタグの無効化です。
revalidateTag と revalidatePath
// app/admin/posts/actions.ts
"use server";
import { revalidatePath, revalidateTag } from "next/cache";
export async function publishPost(slug: string) {
await requireEditor(); // проверка прав — первой строкой
await cms.publish(slug);
revalidateTag(`post:${slug}`); // точечно: одна статья
revalidateTag("posts"); // списки, где она может быть
revalidatePath("/sitemap.xml");
}機能の違い:
revalidateTag(tag)は、どのページで使用されているかに関係なく、このタグを持つすべてのデータ キャッシュ エントリを古いものとしてマークします。revalidatePath(path)は、特定のルートを無効にします。動的セグメントの場合、テンプレートとタイプが示されます:revalidatePath("/blog/[slug]", "page")- 記事のすべてのページ、revalidatePath("/", "layout")- 一般的なすべて。
タグはより正確です。どの URL が表示されるかを推測するのではなく、データを無効にします。 revalidatePath は、データが fetch を介して取得されなかった場合 (たとえば、ラッパーのないデータベースから) に便利です。
どちらの機能もサーバー アクションとルート ハンドラーで動作します。 CMS からの Webhook の場合、revalidateTag を呼び出すシークレット チェックを含むルート ハンドラーを作成します。
データベースへのクエリ用の不安定なキャッシュ
fetch は next 経由でキャッシュされますが、ORM 経由の Postgres へのリクエストはキャッシュされません。これには unstable_cache があります:
// lib/data/stats.ts
import { unstable_cache } from "next/cache";
import { db } from "@/lib/db";
export const getCategoryCounts = unstable_cache(
async (locale: string) => {
const { rows } = await db.query(
"SELECT category, count(*)::int AS n FROM threads WHERE locale = $1 GROUP BY category",
[locale]
);
return rows;
},
["category-counts"], // часть ключа; аргументы добавляются автоматически
{ revalidate: 600, tags: ["threads"] }
);制限事項: 関数内で cookies() および headers() を呼び出すことはできません。リクエストに依存するものはすべて引数として渡します。結果は JSON にシリアル化する必要があるため、Date オブジェクトは文字列として返されます。 unstable_ プレフィックスは、API が変更される可能性があることを意味します。 Next.js 16 では、キャッシュ モデルが再び変更されました (use cache ディレクティブが revalidateTag に変更されます)。アップグレードする際には、お使いのバージョンのドキュメントを確認してください。
何がキャッシュされているかを理解する方法
- 1.
next.config.tsでクエリ ログを有効にします。
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;サーバーコンソールには、fetch ごとにキャッシュのヒットまたはミスを示す行が表示されます。
- 2.セルフホスト型
next startの場合は、キャッシュからのページの応答ヘッダーx-nextjs-cache:HIT、STALE、またはMISSを参照してください。
- 3.
next devではなく、next build && next startビルドを確認します。開発モードでは、キャッシュの動作が異なります。
よくある間違い
revalidateTagがタグなしで受信したデータを更新することを期待します。タグはリクエスト時にバインドされます。
・クライアントコンポーネントから無効化します。 next/cache の関数はサーバー上でのみ動作します。
- バランサーの背後に複数のインスタンス
next start。デフォルトのキャッシュは各インスタンスのファイル システム内にあり、一方のrevalidateTagは他方には影響しません。汎用のcacheHandler(Redis など) が必要です。 - 個人データを共通キーでキャッシュします。答えがユーザーに依存する場合は、ユーザー ID がキーの一部である必要があり、そのようなデータはまったくキャッシュしない方がよいでしょう。
キャッシュが不要な場合
管理パネル、個人アカウント、リアルタイム データを含むページを完全に動的のままにしておく方が簡単です。キャッシュは、同じデータが変更されるよりも多くのユーザーによって読み取られる頻度が高い場合に正当化されます。