Service Worker 是浏览器后台运行的网络拦截器，可拦截请求、缓存资源、实现离线访问；需注册、安装预缓存、拦截响应三步完成离线能力，支持多策略缓存与推送通知，但须 HTTPS 环境且注意生命周期控制。

Service Worker 是浏览器中运行在后台的脚本，独立于网页主线程，能拦截网络请求、缓存资源、推送消息，并让 Web 应用具备离线能力。它不是普通 JS 脚本，不能直接操作 DOM，也不在页面上下文中执行，而是作为网络代理和资源调度中心存在。

Service Worker 的核心能力

它本质是一个可编程的网络拦截器：

• 可捕获页面发起的所有 fetch 请求（包括 HTML、JS、CSS、图片、API 接口）
• 能决定是走网络、读缓存、返回兜底内容，还是组合策略（如缓存优先 + 后台更新）
• 支持后台同步、推送通知、静默更新等增强体验的功能
• 生命周期由浏览器控制：注册 → 安装 → 激活 → 等待 → 控制页面

实现离线应用的三步关键操作

要让网站真正“断网可用”，需完成注册、安装缓存、拦截请求三个环节：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 注册 Service Worker：在主页面 JS 中调用 navigator.serviceWorker.register('./sw.js')。注意 sw.js 必须与页面同源，且建议放在根目录（作用域才覆盖整个站点）
• 安装阶段预缓存静态资源：在 sw.js 的 install 事件里用 cache.addAll(['/', '/index.html', '/app.js', '/style.css']) 把关键文件存入 Cache Storage
• 拦截请求并响应缓存：监听 fetch 事件，对匹配的请求先查缓存 caches.match(req) ，命中则返回；未命中再 fetch 网络并存入缓存（可选），同时 fallback 到一个离线页（如 /offline.html）

实用缓存策略示例

不同资源适合不同策略，常见组合如下：

• 静态资源（HTML/JS/CSS）：采用“缓存优先 + 更新时替换”——安装时预加载，后续请求直接走缓存；新版本安装成功后，在 activate 阶段清理旧缓存
• 图片或字体：可设为“网络优先，失败降级缓存”，避免缓存过期图片
• API 数据：推荐“网络优先 + 缓存兜底”，比如 fetch 失败时返回上一次缓存的数据，并显示“数据可能已过期”提示
• 离线兜底页：所有未匹配路由统一返回 /offline.html，确保用户始终看到有意义的内容而非空白页或报错

注意事项与避坑点

Service Worker 强大但行为严谨，容易因细节出错：

• HTTP 环境下无法注册（开发时可用 localhost，但部署必须用 HTTPS）
• 每次修改 sw.js 文件内容，浏览器会视为新版本并触发重新安装——靠文件内容哈希或时间戳更新可避免误判
• 页面首次加载不会被刚注册的 SW 控制，需刷新一次或调用 skipWaiting() + clients.claim() 主动接管
• 调试时勾选 Chrome DevTools → Application → Service Workers 中的 “Update on reload” 和 “Offline” 可快速验证效果

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南