Next.js 文章已经改了,为什么从首页点进去还看到旧版?

文章封面

客服更新了一条产品说明,作者刷新页面已经看到新版本。另一地区的客户从首页点进去,旧版本还在。运维同事试了硬刷新,偶尔又能看到正确的文案。面对这类报告,先别争哪个缓存「该自动清」,先找出每一层实际交出来的内容版本。

Next.js App Router 有应用数据缓存、路由产物和客户端导航路径。若再加外部 CDN,平时一个 URL 可以被多个业务步骤读取。下面用版本 A 到 B 的示例走查一次,假设这是一篇公开文章,不含登录态。

为一次更新留下能在正文里找到的证据

用测试文章写入一个已知内容版本 B,比如发布系统的内部 revision number,放在测试响应可读的位置。先走能直达源站的请求,再从两个 CDN 区域取样,最后从已有页面软导航进去。把时间和版本一起记。下面命令取正文和响应头,example.com 需换成可控的测试域名。

curl -sS -D headers.txt -o response.html https://example.com/article/42

看 Age、Cache-Control、Vary 和服务商缓存标记。正文版本说明实际拿到的内容,头说明为什么可能是它。如果源站还在给 A,先查文章读取是否同主库提交一致,以及应用按数据 tag 或 path 刷新是否触发。源站有 B,外部 CDN 仍有 A,则按已配置的键核对失效有没有覆盖缓存变体。源站与 CDN 都给 B,旧会话点进去依然见 A,再定位浏览器预取与路由缓存。

把更新版本放到探测输出里,结合各层响应头定位滞后。

一条 URL 可能由 HTML 和 RSC 分别落盘

浏览器硬开详情会取 HTML。App Router 的导航可能取 React Server Component 响应,相关头和查询键参与区分变体。要是在代理里粗略地按路径缓存,导航响应与整页 HTML 可能落到同一个桶。这样出现的就不只是旧内容,客户端甚至会收到格式错误的响应。遵循当前框架和部署平台对变体、Vary 及 _rsc 的具体配置指导。revalidateTag 和 revalidatePath 面向 Next 服务端缓存,外部 CDN 可继续持有内容,需根据 CDN 能力和 TTL 策略部署独立清除。

下面的表来自示意现场。比较时给 直接导航 和 从首页进入 各留一行。

观察点 写入 B 后第一次 五十秒后 线索
直达源站详情 B B 事务与应用缓存可见
北区整页 GET B B 该变体已经失效
南区整页 GET A B 看区域清除是否有延迟
已打开的首页软导航 A A 检查预取与导航变体
新会话首次访问 B B 不复用此前的客户端状态

有一次请求恰好落到已经更新的节点,不足以说明刷新完成。最好让两个地区以相同节奏重复探测,并保留响应头。日志里只记录业务上可公开的修订编号,不上传整页内容或登录信息。

两次更新同时来的时候,谁来保证最后看到的是 B

编辑在一分钟内保存两次,源站从 A 到 B、再到 C。B 的失效通知因网络超时迟到,C 的通知已经处理。用幂等的删除缓存动作再执行 B,通常只是多一次失效;用缓存预热把 B 的响应主动写回,则可能倒退。把「清除旧键」与「预热当前版本」作为不同步骤,预热读取发布后最新的权威版本,并核对任务修订号。每个地区能报告最近一次处理过的内容版本,日后出现 C 又退回 B,才知道按哪条任务日志查。

还有一种麻烦更隐蔽:同一条更新只清详情,首页摘要、专题聚合和订阅源继续引用旧介绍。先把内容依赖列成一个小图。由文章 42 生成的页面至少有详情、作者主页、主题页和搜索索引。每条关系需要实际决定多久会收敛。有些页面可等 TTL,有些必须在同一批事件里主动清。发布管理界面如果只显示「已更新」,可以补一个缓存状态或提供公开探测点,避免编辑同事反复刷新制造新的干扰。

服务端缓存可查可控、CDN 按区域和变体核对、客户端按真实导航重现,这三个步骤留在发布手册。用户提交一个旧页截图时,值班只需要问进入路径、时间、地区和可公开修订号,不必让他清掉所有浏览器状态。

不要在验收里只请求 CDN 的一个公网地址。如果负责缓存的代理对 localhost、内部域名和公开域名使用不同缓存配置,内部请求结果很快,还不能说明用户访问正常。在同一浏览器先用书签直达,再从首页点击,再用返回键重进,逐次记下实际网络请求和响应类型。观察到浏览器没有发起新请求时,问题范围反而小了。只需检查预取、客户端缓存的刷新语义和页面何时重新渲染。

通知缓存这件事要能重试

编辑保存和外部缓存清除落在不同服务,网络超时会带来不确定性。先提交内容,再让持久化的变更事件包含文章 ID、受影响页面和修订号。发布处理器按该版本重试,让 CDN purge 和应用失效都有可追溯结果。若文章详情、首页列表与标签页共用同一数据,表达出各自依赖。有些读者可以在短窗口里看到旧内容,作者本人保存后的反馈则通常要求立刻读到刚才的版本。区分这两类读法,可以做更简单的缓存策略。

评估改动,把指标写成「从提交 B 到主要地区和主要导航入口都能读 B 的秒数」。同时用普通读者验证带身份响应仍保持隔离,别为了排查方便把个性化内容放进共享缓存。下次再看到旧页,只要拿着同一个修订号依次走完这条链,就能很快得到一个具体责任点。

参考资料

Next.js CDN 缓存指南 · Next.js 重新验证文档

评论

暂无评论