火狐浏览器Service Worker离线缓存不主动更新会导致页面功能异常;需勾选“Skip waiting”并刷新,或在sw.js中调用skipWaiting()、定时检查/sw-version.json更新,必要时通过about:debugging注销并清空缓存。
火狐浏览器中Service Worker离线缓存不主动更新,会导致用户始终加载旧版HTML、CSS或JS文件,页面功能错乱、样式失效、按钮无响应,即使服务器已发布新资源也毫无反应。
新注册的Service Worker默认进入waiting状态,必须等所有旧页面关闭才激活;手动触发skipWaiting可立即接管当前页面,避免缓存长期滞留。
1、访问目标网站页面(确保该站已注册Service Worker)→ 按Ctrl+Shift+I(Windows/Linux)或Cmd+Option+I(macOS)打开开发者工具 → 切换到“应用程序”(Application)选项卡。
2、左侧边栏点击“Service Workers”,右侧显示当前注册项;若“Status”列标注为waiting,说明新版本已安装但未激活。
3、勾选下方“Update on reload”和【Skip waiting】两个复选框;此时刷新页面,新Service Worker会立刻接管fetch请求并使用新版缓存逻辑。
4、刷新后,在控制台输入navigator.serviceWorker.controller?.scriptURL,确认返回的sw.js路径是否含最新时间戳或版本号——若仍指向旧文件名,说明脚本本身未更新,需同步检查服务器部署。
仅靠手动skipWaiting无法解决用户长时间不刷新页面的问题;必须让Service Worker自身具备检测并强制更新的能力。
方法一:监听install事件时调用self.skipWaiting()
在sw.js顶部加入以下代码,确保每次新脚本安装即放弃等待:
self.addEventListener('install', event => { self.skipWaiting(); });
方法二:fetch事件中主动检查更新并触发重新注册
在sw.js末尾添加如下逻辑,每24小时向/sw-version.json发起一次HEAD请求比对ETag,若变更则调用registration.update():
setInterval(() => { fetch('/sw-version.json', { method: 'HEAD' }).then(r => { if (r.headers.get('ETag') !== CACHED_ETAG) self.registration.update(); }); }, 24 * 60 * 60 * 1000);
【注意】CACHED_ETAG需在首次install时从响应头读取并保存至localStorage,否则每次都是undefined对比
当跳过等待失败或页面持续被旧Worker控制时,必须彻底移除其注册痕迹与缓存数据,否则新版本无法生效。
第一步:注销Service Worker
1、地址栏输入about:debugging#/runtime/this-firefox并回车 → 等待加载完成 → 在“Service Workers”区域找到目标站点条目(如https://app.example.com/)→ 点击右侧“注销”按钮。
第二步:清空关联缓存存储
2、在同一页面,点击该条目下方的“缓存存储”链接 → 进入Cache Storage管理页 → 逐一点击每个缓存名称(如v2-runtime、precache-202605)→ 点击“删除”按钮。
第三步:重启浏览器并验证
3、关闭所有火狐窗口 → 重新启动 → 访问原网站 → 打开开发者工具→Application→Service Workers,确认状态为activated且scope路径末尾无旧时间戳。