·更新于 2026年11月22日· 43 次浏览 Nuxt 3Vue 3Node.jsRedis缓存BUG解决

Nuxt 3 改完文章首页摘要不更新:我用版本戳、定向失效和 SWR 修好缓存一致性

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

Nuxt 3 改完文章首页摘要不更新:我用版本戳、定向失效和 SWR 修好缓存一致性 封面
ZHOUYI

作者

ZHOUYI

有一次我改了一篇博客的标题和摘要,保存后首页却还显示旧内容。刚开始以为是 Nuxt 3 的页面缓存没刷新,后来发现接口返回的数据本身就是旧的。真正的问题在于:首页摘要被 Redis 缓存住了,而文章更新时没有让这份缓存准确失效。

先给内容加版本戳,别让缓存只认路径

以前我的首页缓存 key 只写了 home,只要首页数据生成过一次,后续都读同一份缓存。文章更新后,缓存并不知道内容已经变了。后来我在 MongoDB 的文章文档里加了 contentVersion 或 updatedAt 字段,每次正文、标题、摘要、封面变化时同步更新。首页缓存 key 改成带版本戳,例如 home:v128,缓存就从“按页面缓存”变成“按内容状态缓存”。

定向失效,而不是清空全站缓存

  • 文章更新后,优先失效首页、列表页、标签页这些会引用摘要的缓存。
  • 文章详情页可以保留较长时间的 HTML 或接口缓存,但要跟着 contentVersion 更新。
  • sitemap、RSS、搜索建议这类派生内容也单独标记失效,避免旧摘要扩散到外部入口。

stale-while-revalidate:先返回旧缓存,再后台回源

js
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 让体验和新鲜度都能兼顾。”

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?