如何在Safari浏览器中使用Web检查器调试具有Service Worker的网页？

必须启用Safari Web检查器Application面板调试：先勾选高级设置中“显示开发菜单”，再打开网页检查器→Application标签，右键Waiting状态Service Worker选择“Skip Waiting”，并核对Cache Storage缓存内容与离线响应逻辑。

当你在Safari中开发PWA时，如果发现离线页面始终不触发、缓存像没写入一样、或者Service Worker一直卡在waiting状态，这时候最直接的办法，就是打开Web检查器的Application面板，手动进行可视化调试。和Chrome那种实时更新、自动激活的机制不同，Safari并没有提供一键“跳过等待”的开关，所有调试动作都得靠开发者工具的底层接口来手动操作。

启用Safari Web检查器并进入Application面板

首先，确保Safari的工具箱是打开的——进入Safari → 设置 → 高级，勾选【在菜单栏中显示‘开发’菜单】。这一步如果跳过，后续所有的调试入口都藏得严严实实，根本看不到。

接下来，打开目标网页（记得必须是HTTPS或者localhost协议才行），点开顶部菜单栏的“开发”，然后选择“显示网页检查器”。在打开的检查器窗口中，切换到Application标签页。如果这个标签页压根没出现，那就要回头检查一下开发菜单是否真的启用了，或者当前页面是不是用了不支持Service Worker上下文的协议（比如file://）。

查看并强制激活等待中的Service Worker

在Application面板的左侧边栏，展开Service Workers。右侧区域会列出当前所有已注册的Service Worker实例，以及它们的具体状态：Activated（表示正在控制页面）、Waiting（新版本已加载完毕，但还没接管）、Installing（还在安装中）。

如果你发现目标Service Worker的状态是Waiting，这说明新的sw.js已经下载好了，但浏览器出于安全考虑，默认不会自动跳过waiting阶段——必须手动推它一把。右键点击这个条目，选择【Skip Waiting】。这个操作会立即终止旧版本Worker，激活新Worker，并让它开始拦截和响应fetch请求。需要特别注意，此操作不可逆，一旦执行，旧版本的缓存策略会立刻失效。

检查预缓存资源是否写入Cache Storage

接下来，展开左侧的Cache Storage，看看里面有没有以你PWA域名命名的缓存（比如https://my-pwa.dev），或者你自己定义在代码里的CACHE_NAME（比如my-pwa-cache-v1）。

如果这里什么缓存列表都没有，说明install事件压根没成功执行。可能的原因包括：sw.js的路径不对（必须使用根相对路径，比如/sw.js）；页面不是通过HTTPS加载导致caches.open()被拒绝；或者event.waitUntil()里面包裹的Promise被reject了，导致安装过程直接中断。

点开任何一个缓存名称，右侧会显示出所有已经缓存的URL列表。这时需要逐个核对，看看index.html、manifest.json，以及关键的JS和CSS文件是否都在里面。如果连最核心的HTML入口文件都没缓存，那离线访问注定会失败。

深度清理废弃Service Worker残留

有三种方法可以处理残留问题，按场景选择：

方法一：在Application面板中直接卸载。找到Service Workers列表中的每个条目，右键点击，如果是Activated状态就选“停止”，如果是Waiting状态就选“取消等待”，之后再选择“卸载”。

方法二：清除对应的Cache Storage。在Cache Storage区域，逐个右键每个缓存名称，选择Delete。如果存在以域名命名的缓存（比如“https://app.example.com”），务必全部删除。

方法三：如果PWA已经卸载了，但通知功能还在触发，那就需要全量清除网站数据。进入Safari → 设置 → 网站，搜索目标域名，点击右侧的“移除全部网站数据”。请注意，此操作会同步清除该域名的Cookies、LocalStorage、IndexedDB以及所有Service Worker的注册信息。