Skip to content

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

  • 生产环境记录注册错误以发现部署问题

相关资源

相关术语

相关课程

  • HTTP

    学习 service worker。

← 返回语言