Service Worker 生命周期陷阱与缓存分层更新策略实战

举报
yd_252100366 发表于 2026/11/13 07:04:34 2026/11/13
【摘要】 一、为什么"发了版,用户还在看旧页面"把 Service Worker(下称 SW)接进一个已有项目,最容易踩的坑不是写不出缓存逻辑,而是上线之后发现:服务器已经更新,用户刷新十次仍然是旧页面。这个问题在带 SW 的项目里有一个专门的名字——僵尸 Service Worker。它不是因为缓存没生效,恰恰是因为缓存生效得太彻底。SW 的更新判定完全依赖浏览器自己:它在导航时按 updateVi...

一、为什么"发了版,用户还在看旧页面"

把 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 交给用户确认、旧缓存延迟一代清理。做到这四点,离线能力与版本一致性可以同时拿到,不需要在两者之间做取舍。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。