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

Next.js 15 中的缓存:在没有默认缓存、revalidateTag 和不稳定缓存的情况下进行获取

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

迁移到 15 后发生了什么变化

在 Next.js 14 中,服务器组件中的 fetch 默认情况下会被缓存。在 15 中,这种行为被逆转了:

  • 除非您显式指定 cache: 'force-cache' 或 next.revalidate,否则 fetch 不会被缓存。
  • 默认情况下,不会缓存路由处理程序中的 GET 处理程序。
  • 页面的客户端路由器缓存不再保存 30 秒的段:动态页面的 staleTime 为零。

更新后的典型情况:API 或数据库的负载增加,因为现在每个页面请求都会检索数据。反之亦然:数据似乎没有被缓存,但页面仍然显示旧的。

陷阱:没有获取缓存,但页面是静态的

如果路由不使用动态 API(cookies()、headers()、searchParams、connection()),Next.js 会在 next build 处预渲染它。未缓存的 fetch 将在构建时执行一次,结果将永远保留在 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。当数据不是通过 fetch(例如,来自没有包装器的数据库)时,revalidatePath 很方便。

这两个函数都在服务器操作和路由处理程序中工作。对于来自 CMS 的 Webhook,请创建一个带有调用 revalidateTag 的秘密检查的路由处理程序。

stable_cache 用于数据库查询

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 build && next start 版本,而不是 next dev 版本:在开发模式下,缓存的行为有所不同。

常见错误

  • 期望 revalidateTag 更新接收到的不带标签的数据。该标签在请求时绑定。
  • 从客户端组件无效。 next/cache 中的函数仅在服务器上工作。
  • 平衡器后面的多个实例 next start。默认缓存位于每个实例的文件系统中,其中一个实例的 revalidateTag 不会影响其他实例。您需要一个通用的 cacheHandler(例如,在 Redis 上)。
  • 在公共密钥下缓存个人数据。如果答案取决于用户,则用户 ID 必须是密钥的一部分,并且最好根本不缓存此类数据。

当不需要缓存时

让管理面板、个人帐户和具有完全动态实时数据的页面变得更加容易。如果许多用户读取相同数据的次数多于更改数据的次数,则缓存是合理的。

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

Ещё на vbcd4u.com