Service Worker 注册失败
快速摘要
你的 service worker 注册失败——Promise 被 reject,离线功能不可用。
为什么发生
SW 脚本通过 HTTP 而非 HTTPS 提供(需要安全上下文)
SW 脚本 URL 返回 404 或 MIME 类型非 text/javascript
SW 文件内有语法错误导致无法安装
最小示例
✗ 错误代码
navigator.serviceWorker.register('/sw.js')
.catch(err => console.error('SW reg failed:', err)); // rejects on HTTP✓ 修复代码
if ('serviceWorker' in navigator && location.protocol === 'https:') {
navigator.serviceWorker.register('/sw.js')
.catch(err => console.error('SW reg failed:', err));
}在 HTTP 上注册 SW 会失败。加协议判断、仅在 HTTPS 上注册可避免 rejection。
如何诊断
查看控制台中注册 rejection 的信息
确认 SW 脚本 URL 返回 200 且 MIME 为 JavaScript
确认页面通过 HTTPS 或 localhost 提供
如何修复
通过 HTTPS 提供站点(开发用 localhost)
修正 SW 脚本路径并确保同源
修复 service worker 文件内的语法错误
如何预防
始终在 HTTPS 或 localhost 上开发 SW
生产环境记录注册错误以发现部署问题