Service Worker 生命周期陷阱与缓存分层更新策略实战
一、为什么"发了版,用户还在看旧页面"
把 Service Worker(下称 SW)接进一个已有项目,最容易踩的坑不是写不出缓存逻辑,而是上线之后发现:服务器已经更新,用户刷新十次仍然是旧页面。这个问题在带 SW 的项目里有一个专门的名字——僵尸 Service Worker。它不是因为缓存没生效,恰恰是因为缓存生效得太彻底。
SW 的更新判定完全依赖浏览器自己:它在导航时按 updateViaCache 规则去请求 sw.js,逐字节比对内容,只有字节不同才会触发 install。也就是说,只要 sw.js 文件本身没变,哪怕你更新了一百个业务资源,SW 都不会重新安装,更不会重新预缓存。这条机制是很多"更新不生效"事故的第一现场。
二、生命周期里被忽略的两个等待
新 SW 安装完成后并不会立刻接管页面,它会进入 waiting 状态,直到所有受控页面(Tab)全部关闭。这是规范刻意的设计,避免新旧两个版本同时处理同一个页面的请求。问题是:用户很少主动关 Tab,于是新版本可能停留几天都上不去。
常见的粗暴解法是在 install 阶段直接调用 self.skipWaiting(),并在 activate 阶段调用 clients.claim()。这段代码几乎每个教程都会给:
self.addEventListener('install', (event) => {
event.waitUntil(
caches.open(VERSION).then((cache) => cache.addAll(PRECACHE_LIST))
.then(() => self.skipWaiting())
);
});
self.addEventListener('activate', (event) => {
event.waitUntil(
caches.keys()
.then((keys) => Promise.all(keys.filter((k) => k !== VERSION).map((k) => caches.delete(k))))
.then(() => self.clients.claim())
);
});
代价是:用户正在填写的表单、正在播放的视频、正在上传的文件,会在一个不确定的时刻被新版本接管,运行时状态与新代码不匹配,报错往往表现为 ChunkLoadError 或莫名其妙的空白页。skipWaiting 不是不能用,而是必须配一个显式的用户确认——检测到 waiting 就弹一条"有新版本,点击刷新",由用户决定时机:
navigator.serviceWorker.register('/sw.js').then((reg) => {
reg.addEventListener('updatefound', () => {
const sw = reg.installing;
sw.addEventListener('statechange', () => {
if (sw.state === 'installed' && navigator.serviceWorker.controller) {
showUpdateToast(() => { sw.postMessage({ type: 'SKIP_WAITING' }); });
}
});
});
});
// 页面侧:收到新 SW 接管后只重载一次,避免刷新死循环
let refreshing = false;
navigator.serviceWorker.addEventListener('controllerchange', () => {
if (refreshing) return;
refreshing = true;
location.reload();
});
三、缓存策略要按资源类型分开,不能一刀切
我见过最常见的错误是把 HTML 也塞进 cache-first。HTML 是版本入口,一旦被缓存,用户的整个站点就被锁死在某个历史版本上,SW 自己的更新逻辑也随之失效。正确做法是分层:
- 带 hash 的静态资源(
app.8f3a1c.js):cache-first,永久缓存,永不主动失效,靠文件名换新。 - HTML 导航请求:network-first,超时 3 秒降级到缓存,保证离线可打开但联网一定拿到最新版本。
- 接口数据:stale-while-revalidate,先给旧数据保证首屏速度,后台静默刷新,下一次访问生效。
- 图片与大文件:cache-first + 容量上限淘汰,不参与预缓存。
network-first 的实现必须处理超时,否则弱网下用户会盯着白屏等到 TCP 超时:
const TIMEOUT = 3000;
function networkFirst(request) {
const network = fetch(request).then((res) => {
const copy = res.clone();
caches.open(RUNTIME).then((c) => c.put(request, copy));
return res;
});
const timeout = new Promise((_, reject) => {
setTimeout(() => reject(new Error('timeout')), TIMEOUT);
});
return Promise.race([network, timeout]).catch(() =>
caches.match(request).then((hit) => hit || caches.match('/offline.html'))
);
}
四、实测:三种策略在同一页面上的差异
测试条件:本地 Node 服务 + Chrome 152,限速 Fast 3G(下行 1.6Mbps,RTT 150ms),页面含 1 个 HTML、3 个 JS、1 个 CSS、12 张缩略图,冷启动三次取中位数。
- 无 SW、纯 HTTP 缓存:首屏 TTFB 均值 412ms,完全可交互 2.1s。
- SW 预缓存 + cache-first:TTFB 均值 6ms,完全可交互 0.9s;但首次发版后,有 37% 的会话在 24 小时内仍命中旧 HTML。
- SW 分层策略(HTML network-first,其余 cache-first):TTFB 均值 9ms,完全可交互 1.0s,发版后第一个导航即拿到新 HTML,旧版本残留降为 0。
结论很明确:cache-first 的收益主要体现在资源密集的页面,而 HTML 一旦被它接管,付出的版本一致性代价远大于那 3ms 的差距。分层策略几乎没有性能损失,却把更新问题从根上解决了。
五、还有两个容易漏的点
第一,sw.js 本身不能被 HTTP 强缓存。如果 CDN 给 sw.js 打了 max-age=31536000,浏览器压根不会去比对字节,更新机制直接失效。这个文件必须配置 Cache-Control: no-cache,允许缓存但每次校验。
第二,activate 里删旧缓存要留缓冲。如果新版本刚激活就立刻删掉旧 cache,而某个还没刷新的旧 Tab 正在读取旧资源,就会出现资源 404 导致的二次白屏。稳妥做法是保留上一版缓存,只清理两版之前的,用 VERSION 命名约定(如 v2026-11-13)配合白名单控制。
六、小结
SW 的更新问题本质不是"缓存写错了",而是生命周期里 waiting 与 controllerchange 的时序没被显式管理。落地时守住四条:sw.js 禁强缓存、HTML 走 network-first、skipWaiting 交给用户确认、旧缓存延迟一代清理。做到这四点,离线能力与版本一致性可以同时拿到,不需要在两者之间做取舍。
- 点赞
- 收藏
- 关注作者
评论(0)