Next.js 15 中的缓存:在没有默认缓存、revalidateTag 和不稳定缓存的情况下进行获取
迁移到 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.在
next.config.ts中启用查询日志记录:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;服务器控制台将显示指示每个 fetch 缓存命中或未命中的行。
- 2.对于自托管
next start,请参阅缓存中页面的响应标头x-nextjs-cache:HIT、STALE或MISS。
- 3.检查
next build && next start版本,而不是next dev版本:在开发模式下,缓存的行为有所不同。
常见错误
- 期望
revalidateTag更新接收到的不带标签的数据。该标签在请求时绑定。 - 从客户端组件无效。
next/cache中的函数仅在服务器上工作。 - 平衡器后面的多个实例
next start。默认缓存位于每个实例的文件系统中,其中一个实例的revalidateTag不会影响其他实例。您需要一个通用的cacheHandler(例如,在 Redis 上)。 - 在公共密钥下缓存个人数据。如果答案取决于用户,则用户 ID 必须是密钥的一部分,并且最好根本不缓存此类数据。
当不需要缓存时
让管理面板、个人帐户和具有完全动态实时数据的页面变得更加容易。如果许多用户读取相同数据的次数多于更改数据的次数,则缓存是合理的。