CDN已更新但PWA仍显示旧页面:检查Service Worker的等待与缓存

区分CDN、HTTP缓存和Service Worker管理的缓存,检查旧标签页、等待激活及版本混用,不把强制接管当作通用修复。

普通新浏览器能看到新版,长期使用网站的用户却一直看到旧页面,问题可能出在Service Worker管理的离线缓存。CDN只控制其中一段分发链路,无法直接替应用完成浏览器端的版本切换。

软件流水线中的构建模块经过校验并使用受限凭证的 AI 示意图
AI概念示意图,不代表实际部署、客户测试或事件现场。

先确认请求由谁提供

在受控测试环境查看页面是否受Service Worker控制,以及目标响应来自网络、HTTP缓存还是脚本管理的Cache Storage。不要在尚未确认来源时连续清空CDN,也不要把“浏览器有缓存”当成足够具体的结论。

记录页面版本、Worker脚本版本和相关缓存名称。它们不一定同步变化,尤其是在用户长时间保持标签页打开的情况下。

新脚本下载不代表已经接管

Chrome开发者文档说明,新Service Worker安装后可能进入等待状态,旧Worker继续控制已有页面;默认激活需要满足相应客户端生命周期条件。

因此“服务器已经提供新脚本”和“当前用户由新脚本控制”是两份证据。应检查实际状态,而不是根据脚本URL最后修改时间推断全部用户已完成升级。

保留旧标签页做一次完整升级演练

  1. 用旧版本打开测试页面,并完成必要的离线缓存。
  2. 发布新版本,观察Worker安装、等待和激活状态。
  3. 在旧标签页继续操作,检查延迟加载资源与接口兼容。
  4. 按应用设计完成刷新或切换,再确认新页面和缓存版本。
  5. 在断网与恢复网络后重复关键功能,确认不会重新落回错误组合。

使用隔离账号和测试数据,避免把生产用户正在填写的内容作为升级试验对象。

强制接管可能制造版本混用

文档提醒,skipWaiting等机制可能让新Worker在旧页面仍运行时接管,影响后续资源加载。是否使用应由应用版本兼容设计决定,不能作为所有更新问题的通用按钮。

如果需要提示用户刷新,应说明正在发生更新,并妥善处理未提交内容。只让用户反复清浏览器数据,会掩盖生命周期设计问题,也可能破坏其本地业务状态。

旧缓存清理应只针对本应用的范围

激活新版本时,根据明确版本清单清理不再需要的对象,避免误删仍被其他功能使用的缓存。保留旧资源的时间与页面生命周期相配合,不要在旧页仍会引用它们时立即删除。

如果新Worker脚本本身仍从上游拿到旧版本,再回头检查部署和CDN配置。这样能够区分分发未更新与浏览器尚未激活,不把两个问题混为一谈。

接入CDN加速的PWA应把浏览器升级演练列入发布验收。最终证据包括真实客户端的控制状态和业务结果,不能只有边缘刷新成功的记录。

资料核对日期:2026年10月30日。本文由AI辅助整理,技术事实依据文内原始资料核对。示例与操作清单供实施参考;产品配置和软件维护状态以实施时的官方资料为准。

继续阅读:网站安全与加速专题 · 内容说明与纠错

涉及漏洞与安全事件的文章,请结合文中来源、发布时间和厂商最新公告核对。产品配置与防护效果以实际业务验证为准;资料纠错可联系 support@waf.pro。

WAFPRO最新文章

商品图片通过CDN动态缩放:怎样控制变体数量和更新范围

2026-11-18 14:00:00

WAFPRO最新文章

Next.js 2024缓存漏洞复盘:框架的动态页面为什么也要检查CDN策略

2026-11-18 20:00:00

❯
搜索