发版后有 3% 的用户一直看到旧页面,强制刷新才好。查下来是 Service Worker 把 404 响应也缓存了,接口报错那次请求被存进 cache,之后每次命中都返回 404。
SW 的 fetch 事件里写的是 cache-first,先 caches.match,命中就直接返回,没看 response.ok。后端某次发布把接口路径改了 20 分钟,这 20 分钟的请求全写进了缓存。
和 HTTP 缓存打架的地方在版本号。Cache-Control 设的 max-age=600,SW 的 cache 名还是 v3,一个月没动。浏览器先命中 SW,HTTP 缓存头根本没机会生效。
改了三处:只缓存 response.ok 且 type 为 basic 的响应;cache 名跟着构建号走,activate 时删旧版本;导航请求走 network-first,失败才回缓存。
有个细节容易踩:sw.js 本身被 Cache-Control 缓存 24 小时,用户要等一天才能拿到新版本。灰度环境里我把 max-age 设成 86400,改完一天没生效,排查了半天以为逻辑写错。现在发版前会 curl -I 看一眼这个文件的 cache-control 和 etag,确认是 no-cache 再上线。
self.addEventListener('fetch', function (e) {
if (e.request.mode !== 'navigate') return;
e.respondWith(
fetch(e.request).then(function (res) {
if (!res.ok) return res;
const copy = res.clone();
caches.open('v7').then(function (c) {
c.put(e.request, copy);
});
return res;
}).catch(function () {
return caches.match(e.request);
})
);
});
还要处理已经装了旧 SW 的用户。skipWaiting 加 CLIents.claim 能让新版本立刻接管,但正在填表单的页面会被刷新,我们在提交中的页面加了 beforeunload 提示。上线第一天旧缓存命中率从 12% 掉到 0.3%。现在每发一版都用无痕窗口装一次新 SW,确认版本号变了才推下一台机器。
