service worker注册失败根本原因是https缺失（仅localhost例外）或sw.js路径错误；需用绝对路径如"/sw.js"、确保同源、content-type为text/javascript，并在load事件后注册。
为什么 navigator.serviceWorker.register() 总是失败？
根本原因通常是服务工作线程（SW）脚本路径错误或未满足 HTTPS 要求。本地开发时 http://localhost 是唯一被允许的非 HTTPS 场景，其他所有环境必须走 HTTPS，否则 navigator.serviceWorker 直接为 undefined 或注册立即 reject。
常见错误现象：Uncaught (in promise) DOMException: Failed to register a ServiceWorker，或控制台提示 Service worker registration failed: TypeError: Cannot read property 'register' of undefined。
- 确保 SW 脚本路径是**绝对路径**（如
/sw.js），避免相对路径导致 404 - 检查浏览器是否禁用了服务工作线程（例如隐私模式、某些企业策略）
- 确认脚本响应头含
Content-Type: application/javascript，否则 Chrome 会拒绝注册 - SW 文件不能跨域加载——
sw.js必须与页面同源
调用 registration.pushManager.subscribe() 前必须先获取用户授权
pushManager.subscribe() 不会自动弹出权限框；它依赖已有的 Notification.permission === "granted"。如果权限是 "default" 或 "denied"，调用直接抛错：DOMException: Permission denied。
正确流程是：先显式调用 Notification.requestPermission()，且必须由用户手势（如点击按钮）触发，否则会被浏览器静默拒绝。
- 不要在页面加载完成时自动请求权限——99% 的浏览器会忽略或降级为
"default" - 检查返回值：
if (permission === "granted") { subscribe() }，别假设 requestPermission() 一定成功 - 移动端 Safari 完全不支持 Push API，
pushManager在 iOS 上始终为undefined
订阅对象里的 endpoint 和 keys 怎么用？
成功订阅后得到的 PushSubscription 对象包含 endpoint（唯一推送地址）和 keys（p256dh 与 auth），三者缺一不可。后端发送推送时必须用 keys 加密 payload，并通过 endpoint 发起 POST 请求。
常见误操作：只存 endpoint 到数据库，漏存 keys，导致后续推送全部解密失败（服务端报 400 Bad Encryption）。
-
endpoint是长 URL，可能含查询参数，务必完整保存（长度常超 300 字符） -
keys.p256dh和keys.auth是 base64url 编码字符串，不是标准 base64，注意替换-→+、_→/后再解码 - 每次订阅都是新 endpoint —— 用户重装浏览器、清除站点数据后，旧 endpoint 失效，需重新订阅
后端发推送时收到 410 Gone 或 404 Not Found
这两个状态说明 endpoint 已失效：410 表示推送服务明确废弃该订阅（如用户取消订阅、设备离线超期），404 多见于 endpoint 被手动删除或格式损坏。
你不能靠前端“记得”订阅状态来规避——服务端必须主动处理失效反馈，并从数据库清理对应记录。
- 每次推送后检查响应状态码，遇到
410或404立即删掉该用户的 subscription 记录 - Chrome 推送服务对长期不活跃的 endpoint 会在几周后回收，不发通知
- 不要复用旧 subscription 对象重试——必须重新调用
subscribe()获取全新 endpoint
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
