一个博客的缓存策略:每份数据缓存多久、谁来让它失效

Next.js 16 开启 Cache Components 后,缓存从页面配置变成了数据声明。一张表列出博客里每份数据的缓存时长和失效方式,再加三个实测踩到的坑:404 也会被缓存、tag 粒度太粗、路由取最短的缓存时间。

开启 Cache Components 之后,Next.js 16 的缓存思路变了:不再问「这个页面是静态还是动态」,而是问「这份数据能缓存多久、什么时候失效」。页面能不能静态化,是由它用到的数据推导出来的。

这篇不讲迁移过程(那是《同一个页面的三张路由表》的内容),只记这个博客最后定下来的缓存策略,以及几个实测出来的坑。

三个工具

  • 'use cache' :写在取数函数里,缓存这个函数的返回值。缓存 key 由框架自动生成,包含函数位置、序列化后的参数等,getPostBySlug('a') 和 getPostBySlug('b') 是两条缓存。像 Nuxt 的 defineCachedFunction ,只是不用手写 key。
  • cacheLife :缓存多久。三个时间:stale 管客户端多久不问服务器;revalidate 过期后,下一个请求先拿旧的、后台重建;expire 是长时间没流量后的硬上限,过了就同步等新数据。
  • cacheTag :给缓存贴标签,之后按标签失效。

策略表

所有读文章的查询都收在 lib/posts.ts 里,每个函数自己声明缓存:

数据用在哪cacheLifetag怎么失效
getPostBySlug(slug)文章页'max'posts发布时 updateTag
getPostsPage(page) 、getPublishedCount()列表页、分页页'max'posts发布时 updateTag
getSitemapPosts()sitemap'max'posts发布时 updateTag
getHotPosts()首页热门'hours'无每小时自动过期
Markdown 渲染结果文章正文'max'无不需要:内容变了,缓存 key 就变了

分两类:

由事件驱动的数据(文章内容、列表、sitemap)只在发布时变。缓存时间设成最长,靠发布时主动失效。

没有事件可挂的数据(按阅读量排序的热门列表)随时在变,但没有一个「发布」这样的时机去通知它,只能定时刷新。它故意不打 posts 标签:热门和发布无关,发一篇新文章不该让首页重建。

Markdown 组件加缓存是被逼出来的:代码高亮库 shiki 内部用 Date.now() 计时,预渲染时会报错。渲染结果只取决于正文内容,内容就是缓存 key,不需要标签。

发布时用哪个失效 API

发布文章的 Server Action 里只有一行:

updateTag('posts')

三个候选的区别,都实测过:

API发布后下一个请求拿到能在哪调用
updateTag('posts')新内容只能在 Server Action
revalidateTag('posts', 'max')旧内容,后台重建;实测约 6 秒内的请求都是旧的Server Action、Route Handler
revalidatePath(path)新内容都可以

选 updateTag :发布的人就是马上要去看结果的人,用 'max' 的话,作者发布后看到的还是旧页面,新文章页甚至显示「不存在」。revalidateTag 适合 CMS webhook 回调 Route Handler 这类场景,访客晚几秒看到新内容无所谓。

没用 revalidatePath ,不是因为它不行。实测它也能让 use cache 的数据失效:Next 会按路由路径给缓存自动生成隐式 tag,revalidatePath 失效的就是这些 tag。问题在维护性:按路径失效,要求写发布逻辑的人记住哪些页面读了文章数据。后来加 sitemap 时,如果用的是路径失效,就得记得补一行;忘了不会报错,只会静默显示旧内容。按 tag 失效,谁读数据谁声明 tag,发布方不需要知道有哪些页面。

三个坑

404 也会被缓存

这个坑踩了两次。

第一次在静态生成阶段:发布前访问了一个还不存在的文章地址,返回 404,第二次请求是 HIT ,磁盘上真的生成了这个 404 页面。如果发布时漏了失效详情页,这篇文章会一直 404。

第二次在分享卡片图上,更隐蔽。图片路由查不到文章时调了 notFound() ,这个 404 被缓存了,而且缓存文件里没有任何 tag。正常生成的图带着 posts 标签,发布时会被清掉;这条 404 没有标签,updateTag('posts') 清不到它。结果是:发布前有人请求过这张图,发布后分享卡片一直是 404。

改成查不到时返回一张站点默认卡片后,缓存条目是 200,带着 posts 标签,发布时能被清掉。

结论:按需生成的路由,「查不到」的结果也会进缓存。要确认这条缓存能被你的失效方式清掉。 最直接的检查办法是去 .next/server/app/ 下找对应的 .meta 文件,看 x-next-cache-tags 。

tag 粒度太粗

所有文章共用一个 posts 标签。实测发布一篇新文章,一篇无关的旧文章页也被重建了。文章少时无所谓;文章多了,应该给每篇再加一个 post:<slug> ,编辑单篇时只失效它和列表。

路由的缓存时间取最短的那个

路由表里的 Revalidate / Expire 列,取的是页面用到的所有缓存函数里最短的那个。getPostsPage 一度误写成 'hours' ,/posts 就显示 1h 1d ,而分页页 /posts/page/2 显示 30d 1y ,两个本该一致的页面对不上,才发现这个错。改成 'max' 后两者一致。

顺带一个对照:首页 'hours' 的响应头是 Cache-Control: s-maxage=3600, stale-while-revalidate=82800 。82800 等于 1 天减 1 小时,也就是 s-maxage 对应 revalidate ,两者相加等于 expire 。CDN 那一层的缓存行为,就是从 cacheLife 直接换算出来的。

小结

缓存策略最后归结成两个问题:

  1. 这份数据什么时候会变? 由事件驱动的,缓存时间拉满,事件发生时主动失效;没有事件可挂的,按能接受的延迟定时刷新。
  2. 失效时,谁需要马上看到? 作者自己要看,用 updateTag ;访客晚几秒无所谓,用 revalidateTag 。

剩下的就是验证:每一类数据都按「先请求 → 触发失效 → 再请求」走一遍,看响应头的 x-nextjs-cache 是不是从 HIT 变成了 MISS 。

AI 只依据本文内容回答,可能出错,请以原文为准。