本地开发时Service Worker常不生效,因更新需字节变化且仅下次加载尝试安装;须用DevTools勾选Update on reload、手动unregister,并配对使用skipWaiting()与clients.claim()。

如何正确注册 Service Worker
注册是启动一切的前提,但容易因路径、作用域或执行时机出错:
-
navigator.serviceWorker.register()必须在页面加载后、且navigator.serviceWorker可用时调用(常见于window.addEventListener('load', ...)) - 注册路径默认以 HTML 文件所在目录为基准,若
sw.js放在根目录,需显式写成navigator.serviceWorker.register('/sw.js'),否则可能注册到子路径下导致作用域过窄 - 注册失败不会抛异常,需监听
registration.onupdatefound或检查console中的 “failed to register” 提示
Service Worker 的三大核心功能是什么
它本质是一个可编程的网络代理,关键能力只有三个,其他都是衍生:
- 离线缓存控制:通过
caches.open()+cache.put()预存资源,在install事件中完成;后续用fetch事件拦截请求并从缓存匹配 - 网络请求拦截与响应定制:在
fetch事件中调用event.respondWith(),可返回缓存响应、发起新fetch()、甚至生成new Response() - 后台消息通信与生命周期管理:支持
postMessage()与主页面双向通信;activate阶段常用来清理旧缓存(caches.delete()),避免缓存爆炸
常见的缓存策略怎么选
没有“万能策略”,选错会导致白屏、旧资源不更新或反复请求:
- Cache-First:优先读缓存,失败再 fetch;适合静态资源(JS/CSS/图标),但需配合
activate清理旧版本 - Network-First:先发网络请求,超时或失败才 fallback 到缓存;适合内容页,但需设置合理 timeout(浏览器无原生 timeout,得用
AbortController) - Stale-While-Revalidate:立即返回缓存,同时后台 fetch 更新缓存;用户体验好,但代码稍复杂,需在
fetch中并发处理两个响应流
self.addEventListener('fetch', event => { const url = new URL(event.request.url); if (url.origin === location.origin && url.pathname.startsWith('/api/')) { // API 请求走 Network-First event.respondWith( fetch(event.request).catch(() => caches.match(event.request)) ); } else { // 静态资源走 Cache-First event.respondWith( caches.match(event.request).then(res => res || fetch(event.request)) ); } });
为什么本地开发时经常“不生效”
这是最常被卡住的环节,根本原因在于 Service Worker 的作用域和更新机制:
立即学习“Java免费学习笔记(深入)”;
- 每次修改
sw.js后,浏览器不会立即启用新版本——它只在下次页面加载时“尝试安装”,且仅当文件内容字节不同才触发更新(空格、注释变化无效) - Chrome DevTools 的
Application > Service Workers面板里勾选Update on reload和Unregister手动清除,是调试必备操作 -
localhost允许 HTTP,但某些安卓 webview 或旧版 ios safari 仍会拒绝注册,务必真机测试 -
skipWaiting()和clients.claim()要配对使用,否则新 SW 安装后不会接管当前页面,导致“看似注册成功却没缓存”
Service Worker 的复杂性不在语法,而在它打破了传统前端“请求即响应”的线性模型——你得同时考虑安装、激活、缓存版本、网络兜底、客户端同步等多个状态。漏掉任意一环,PWA 就只剩一个 manifest.json 图标。