Chrome转Safari扩展失败：service_worker加载错误排查求助

关于webRequest事件的错误提示 #

虽然Chrome v107修复了非持久化后台页监听webRequest的问题，但Safari对Manifest V3的实现和Chrome存在差异。当前Safari的Manifest V3扩展中，非持久化的Service Worker确实无法监听webRequest事件，这属于Safari的现有限制。如果你的扩展依赖该API，建议：

• 确认Safari官方文档中webRequest与Service Worker的兼容状态；
• 暂时考虑回退到Manifest V2（如果允许），或者寻找功能替代方案（比如使用declarativeNetRequest，需评估功能覆盖度）。

Service Worker加载失败的具体排查步骤 #

1. 简化Service Worker代码定位语法/API问题 #

把background.js替换成最基础的测试代码：

console.log('Background service worker loaded');

chrome.runtime.onInstalled.addListener(() => {
  console.log('Extension installed');
});

如果简化后能正常加载，说明原background.js中存在语法错误、使用了Safari不支持的ES特性，或者调用了Chrome独有的API（比如chrome.runtime.getPackageDirectoryEntry这类WebKit尚未实现的接口）。逐步回加代码，定位具体出错点。

2. 验证文件路径准确性 #

确认manifest.json中background.service_worker指定的路径（background.js）是否与实际文件位置匹配：

• 检查构建后产物的目录结构，若使用打包工具（Webpack/Vite等），需确认打包后的Service Worker文件是否输出到了根目录，或者路径配置是否正确；
• Safari对相对路径的解析更严格，避免使用./background.js以外的复杂路径（子目录路径需确保manifest中配置正确）。

3. 排查Content Security Policy（CSP）限制 #

你的CSP配置包含'wasm-unsafe-eval'，Safari对CSP的执行可能更严格：

• 暂时将CSP放宽为"script-src 'self' 'unsafe-eval'; object-src 'self'"测试，若Service Worker能加载，则说明原CSP中的wasm-unsafe-eval或其他规则阻止了脚本加载；
• 检查background.js中是否加载了外部资源（比如远程脚本、未在CSP中允许的资源），这类操作会触发CSP拦截。

4. 挖掘更详细的错误日志 #

Safari默认给出的错误提示不够详细，可通过以下方式获取日志：

• 打开macOS自带的「控制台」应用，搜索关键词Safari或WebExtension，查看Service Worker加载时的具体报错（比如文件缺失、语法错误、权限拒绝等）；
• 在Safari开发者工具的「扩展」面板中，查看已加载扩展的后台日志（若Service Worker成功加载部分代码，这里会输出相关信息）。

5. 检查Manifest字段与权限的兼容性 #

Safari对Manifest V3的部分字段和权限支持尚未完全对齐Chrome：

• 移除content_scripts中的match_origin_as_fallback字段（该字段为Chrome特有，Safari可能未实现，导致manifest解析异常）；
• 暂时移除非核心权限（比如downloads、alarms），测试Service Worker是否能加载，再逐个添加权限排查冲突。

6. 对比最简Manifest V3扩展 #

创建一个极简的Manifest V3扩展，确认其能在Safari正常运行：

{
  "name": "Test Extension",
  "manifest_version": 3,
  "background": {
    "service_worker": "background.js"
  },
  "action": {
    "default_popup": "popup.html"
  },
  "permissions": ["tabs"]
}

若该极简扩展能正常运行，对比你的项目代码和配置，找出差异点（比如第三方依赖、特殊API调用等）。

内容的提问来源于stack exchange，提问作者Søren Bruus Zeppelin