Chrome扩展Service Worker注册失败（状态码2）问题咨询

状态码2的含义 #

该状态码对应Chrome内部定义的REGISTRATION_FAILED_STATUS_UNSUPPORTED，本质是当前使用的Chrome稳定版不支持该Manifest v3扩展所需的Service Worker相关特性或Manifest规范要求。Canary作为预发布版本，包含了更多未正式推送的特性支持，因此能正常加载扩展。

解决方法 #

• 升级Chrome到最新稳定版：Manifest v3对Chrome版本有最低要求（至少v88），但部分新特性需要更高版本。将Chrome稳定版更新到官方最新版本，大概率能解决版本不兼容导致的问题。
• 校验Manifest文件配置：确认manifest.json中的service_worker字段路径正确，路径需为相对扩展根目录的格式（例如"service_worker": "sw.js"），避免拼写错误或使用绝对路径。
• 检查Service Worker代码兼容性：排查Service Worker脚本中是否使用了Chrome稳定版尚未支持的API，对比Canary与稳定版的API支持差异，替换或移除未兼容的代码。
• 重置扩展加载状态：在Chrome扩展管理页面（chrome://extensions/），先移除该未打包扩展，再重新加载；或点击扩展卡片上的"重新加载"按钮，清除可能存在的缓存异常。
• 临时启用实验性特性（不推荐长期使用）：若无法升级Chrome，可在chrome://flags页面搜索并启用#extension-manifest-v3、#service-worker-on-background-thread相关实验开关，但该操作可能带来稳定性风险，仅作为临时方案。

内容的提问来源于stack exchange，提问作者samuelfullerth