Service Worker 返回 200 但页面是旧的 怎么强制更新缓存

现象

静态资源重新部署后,用户刷新看到的还是旧版 HTML,引用的依旧是旧的 main.3f2a.js,只有强制刷新或者清缓存才恢复。控制台里 Service Worker 已经是 activated 状态,Network 面板显示请求走了 Service Worker,状态码 200,内容却是上一版。

原因

fetch 事件里如果缓存优先命中,就会直接返回 CacheStorage 里的旧响应,网络请求根本没发出去。activate 阶段没有调用 CLIents.claim(),新 Worker 不会接管已经打开的页面;预缓存清单没有版本号时,install 阶段还会复用旧缓存,导致新旧资源混在一起。

解决步骤

第一步,给缓存名加版本,并在 activate 里删除旧缓存。同时在新版本安装后立刻接管页面,避免用户要关掉所有标签才生效。

const CACHE = "static-v3";
self.addEventListener("install", (e) => {
  e.waitUntil(caches.open(CACHE).then((c) =>
    c.addAll(["/", "/index.html"])));
  self.skipWaiting();
});
self.addEventListener("activate", (e) => {
  e.waitUntil(caches.keys().then((keys) =>
    Promise.all(keys.filter((k) => k !== CACHE)
      .map((k) => caches.delete(k)))));
  self.clients.claim();
});

第二步,把 HTML 请求改成网络优先。navigate 类型的请求先 fetch 网络,失败再回退到缓存里的 index.html;只有 js、css、图片这类带哈希的静态资源才用缓存优先。

第三步,注册时加 updateViaCache 为 none。页面加载完成后主动调用一次 registration.update(),让浏览器每次都检查 sw.js 有没有变化,不要等服务端缓存过期。

验证

在 Application 面板勾选 Update on reload,部署新版本后刷新,Cache Storage 里应只剩新的缓存名;再切到离线模式访问,页面能打开且资源版本正确,不出现白屏。

小结

旧页面问题的核心是缓存名和接管时机。版本化缓存名、HTML 网络优先、注册时关掉脚本缓存三步做完,发布后用户刷新一次就能拿到新版本。

您可以还会对下面的文章感兴趣: