v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:02:00.000Z▲ 0 upvotes

Next.js 15 でのキャッシュ: デフォルトのキャッシュ、revalidateTag、unstable_cache を使用しないフェッチ

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

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. 1.next.config.ts でクエリ ログを有効にします。
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;

サーバーコンソールには、fetch ごとにキャッシュのヒットまたはミスを示す行が表示されます。

  1. 2.セルフホスト型 next start の場合は、キャッシュからのページの応答ヘッダー x-nextjs-cache: HIT、STALE、または MISS を参照してください。
  1. 3.next dev ではなく、next build && next start ビルドを確認します。開発モードでは、キャッシュの動作が異なります。

よくある間違い

  • revalidateTag がタグなしで受信したデータを更新することを期待します。タグはリクエスト時にバインドされます。

・クライアントコンポーネントから無効化します。 next/cache の関数はサーバー上でのみ動作します。

  • バランサーの背後に複数のインスタンス next start。デフォルトのキャッシュは各インスタンスのファイル システム内にあり、一方の revalidateTag は他方には影響しません。汎用の cacheHandler (Redis など) が必要です。
  • 個人データを共通キーでキャッシュします。答えがユーザーに依存する場合は、ユーザー ID がキーの一部である必要があり、そのようなデータはまったくキャッシュしない方がよいでしょう。

キャッシュが不要な場合

管理パネル、個人アカウント、リアルタイム データを含むページを完全に動的のままにしておく方が簡単です。キャッシュは、同じデータが変更されるよりも多くのユーザーによって読み取られる頻度が高い場合に正当化されます。

Обсуждение (0)

Ещё на vbcd4u.com