一个博客的缓存策略:每份数据缓存多久、谁来让它失效
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 里,每个函数自己声明缓存:
| 数据 | 用在哪 | cacheLife | tag | 怎么失效 |
|---|---|---|---|---|
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 直接换算出来的。
小结
缓存策略最后归结成两个问题:
- 这份数据什么时候会变? 由事件驱动的,缓存时间拉满,事件发生时主动失效;没有事件可挂的,按能接受的延迟定时刷新。
- 失效时,谁需要马上看到? 作者自己要看,用
updateTag;访客晚几秒无所谓,用revalidateTag。
剩下的就是验证:每一类数据都按「先请求 → 触发失效 → 再请求」走一遍,看响应头的 x-nextjs-cache 是不是从 HIT 变成了 MISS 。