Nuxt 3 改完文章首页摘要不更新:我用版本戳、定向失效和 SWR 修好缓存一致性
一次改完文章后,首页摘要仍显示旧内容。问题不在页面渲染,而在缓存键太粗、失效不够精准。本文记录我用内容版本戳、定向失效和 stale-while-revalidate 恢复一致性的做法。

作者
ZHOUYI
有一次我改了一篇博客的标题和摘要,保存后首页却还显示旧内容。刚开始以为是 Nuxt 3 的页面缓存没刷新,后来发现接口返回的数据本身就是旧的。真正的问题在于:首页摘要被 Redis 缓存住了,而文章更新时没有让这份缓存准确失效。
先给内容加版本戳,别让缓存只认路径
以前我的首页缓存 key 只写了 home,只要首页数据生成过一次,后续都读同一份缓存。文章更新后,缓存并不知道内容已经变了。后来我在 MongoDB 的文章文档里加了 contentVersion 或 updatedAt 字段,每次正文、标题、摘要、封面变化时同步更新。首页缓存 key 改成带版本戳,例如 home:v128,缓存就从“按页面缓存”变成“按内容状态缓存”。
定向失效,而不是清空全站缓存
- 文章更新后,优先失效首页、列表页、标签页这些会引用摘要的缓存。
- 文章详情页可以保留较长时间的 HTML 或接口缓存,但要跟着 contentVersion 更新。
- sitemap、RSS、搜索建议这类派生内容也单独标记失效,避免旧摘要扩散到外部入口。
stale-while-revalidate:先返回旧缓存,再后台回源
const key = `home:v${post.contentVersion}`;
const cached = await redis.get(key);
if (cached) {
refreshHomeInBackground(key).catch(() => {});
return cached;
}
const fresh = await buildHome();
await redis.set(key, fresh, 'EX', 300);
return fresh;这里我没有粗暴地关掉缓存,而是采用 stale-while-revalidate 的思路:用户先拿到已有缓存,保证首页响应快;同时后台异步重新生成新摘要。生成完成后写入新的版本 key,下一次请求就能拿到新内容。为了避免同一时间大量回源,后台刷新函数里最好加一个简单的锁或标记,防止多个请求同时重建首页。
“缓存一致性不是“缓存多久”的问题,而是“缓存凭什么还有效”的问题。版本戳让缓存有身份,定向失效让更新有边界,SWR 让体验和新鲜度都能兼顾。”