Capacitor Service Worker 加载失败改一个配置项快速搞定【免费下载链接】capacitorBuild cross-platform Native Progressive Web Apps for iOS, Android, and the Web ⚡️项目地址: https://gitcode.com/gh_mirrors/ca/capacitor你把 PWA 用 Capacitor 打包成原生应用后页面能正常打开唯独 Service Worker 死活注册不上——离线能力全废控制台一片报错。Capacitor 是构建 iOS、Android 与 Web 跨平台原生 PWA 的框架这类问题在 7.x 版本里几乎都指向同一个根源一个默认开启的桥接配置项。下面按先判断、再讲原理、后动手的顺序给你排掉它。 故障长什么样先对号入座确认你遇到的是同一个问题看这三个症状有没有命中任意一条控制台出现类似ServiceWorker script fetch failed的报错或注册脚本拿到的是乱码/HTML 而不是 JSDevTools 里 Application → Service Workers 面板中你的 SW 显示未注册或一直停在未激活状态联网时页面一切正常一断网就回退失败缓存策略完全没有生效三个症状都说明请求链路被中间层动了手脚而中间层正是 Capacitor 的桥接机制。原理先行默认配置为什么会拦死 Service Worker改配置之前先搞清冲突发生在哪。Capacitor 7.0 引入了resolveServiceWorkerRequests配置项默认值为true声明位置见 配置声明源码。它的含义是让 Service Worker 的请求也走 Capacitor 桥。为 true 时Android 端在桥初始化阶段会注册一个ServiceWorkerClient把 SW 的每个请求都转给本地服务器的shouldInterceptRequest处理具体逻辑在 Bridge.java。问题是这个本地服务器天生只服务你webDir下的静态资源请求 URL 能匹配上路由才响应匹配不上就按代理规则转发或直接返回 null。于是 SW 的注册脚本、install 阶段的 fetch 一旦进入这条管线就可能被转发到错误的地址或无响应注册/激活流程就此被打断。这就是浏览器里正常、原生端注册不上的常见根源。动手修改配置一行 JSON 解决修复方法就一句话在capacitor.config.json的android节点下加一行resolveServiceWorkerRequests: false。注意它必须嵌套在android里不是顶层字段完整示例{ appId: com.example.app, appName: My App, webDir: www, android: { resolveServiceWorkerRequests: false } }设为 false 的含义是放弃让桥代理 SW 流量WebView 会走系统网络栈直接请求 SW 脚本和缓存资源SW 生命周期回归浏览器标准行为也就不再和本地服务器的路由表冲突。另外这个配置只有 Android 侧有对应读取逻辑iOS 项目不用动它。同步与验证cap sync 开发者工具配置改完不会自动生效需要同步到原生工程再重新构建npx cap sync然后按顺序验证重新构建并安装 App打开目标页面设备用 USB 连上电脑Chrome 打开chrome://inspect对目标设备点 inspect在 DevTools 的 Application → Service Workers 面板确认两点SW 状态为activatedscope 覆盖你预期的路径状态从未注册变成激活、控制台不再刷 fetch 报错说明修复成功。高频追问Q改了配置还是没生效怎么办按顺序查三处一是 key 是否误写在顶层——必须位于android节点下二是改完有没有跑npx cap sync配置要同步后才会写进原生工程三是你当前是否在 dev serverlive reload模式下运行开发模式下应用指向的是本机开发服务器请用webDir的构建产物验证。都确认无误仍不行的话卸载旧 App 重装排除旧的 SW 缓存干扰。Q什么情况该保留 truetrue 是默认值它的用意是让 SW 的请求也经过本地服务器统一处理——如果你的 SW 只 fetchwebDir下的本地资源比如 precache 打包好的静态文件保留 true 时行为和普通页面更一致。经验法则是注册失败或 fetch 报错就设为 false默认没出问题就别动。改成 false 后要自己保证 SW 的请求可达比如 SW 部署在远端时域名和 CORS 需要自行配好。整套流程就是改一行配置 → 跑一次 cap sync → 到 chrome://inspect 确认 activated这是目前排查 Capacitor Service Worker 加载失败最直接的路径。关于resolveServiceWorkerRequests的更多细节可查 Capacitor 官方文档与社区论坛。【免费下载链接】capacitorBuild cross-platform Native Progressive Web Apps for iOS, Android, and the Web ⚡️项目地址: https://gitcode.com/gh_mirrors/ca/capacitor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考