MV3 Safari Web Extension iOS端service_worker加载失败求助

问题描述 #

用Manifest V3开发的Safari网页扩展在macOS运行正常，但iOS端报错：the service_worker script failed to load due to an error。背景脚本background.js在Chrome和macOS Safari下无报错，manifest配置如下：

"background": {
  "service_worker": "background.js",
  "type": "module"
}

排查发现报错由以下三个监听事件导致，即使仅在事件回调中添加console.log也会触发崩溃：

browser.runtime.onStartup.addListener(async () => {
  // 仅console.log也会报错
});

browser.runtime.onConnect.addListener((port) => {
  // 仅console.log也会报错
});

browser.tabs.onUpdated.addListener(function (tabId, changeInfo, tab) {
  // 仅console.log也会报错
});

可能的修复方案 #

• 移除type: "module"配置：Safari iOS对模块类型的Service Worker支持存在兼容性问题，删除manifest中的type字段，将background.js改为普通脚本而非ES模块，多数情况下能解决加载失败问题。
• 确保事件注册在顶层作用域：事件监听必须在Service Worker的顶层作用域同步注册，不能放在异步函数、延迟执行逻辑中。iOS Safari的Service Worker启动时需要立即识别事件监听器，否则会判定加载失败。
• 验证API兼容性：部分MV3 API在iOS Safari上的支持与桌面端有差异，比如runtime.onStartup在iOS上没有系统启动触发的场景，可以先注释掉该事件监听，测试是否能正常加载。
• 简化回调逻辑：即使是console.log，也可能因iOS Safari的Service Worker日志机制问题导致崩溃，可暂时移除所有回调内容，只保留事件注册语句，确认加载正常后再逐步添加逻辑。

iOS端调试思路 #

• 远程调试查看详细错误：
  1. 打开mac端Safari的「偏好设置」-「高级」，勾选「显示开发菜单」。
  2. iOS设备连接mac后，在iOS「设置」-「Safari浏览器」-「高级」中开启「Web检查器」。
  3. 在mac端Safari的「开发」菜单中选择连接的iOS设备，找到对应扩展的背景页，查看控制台的具体错误信息（原始报错仅提示加载失败，控制台会显示语法错误、API不支持等细节）。
• 逐步排查代码：
  1. 注释所有事件监听，写一个仅注册onInstall事件的基础Service Worker，测试是否能正常加载。
  2. 逐个添加三个事件监听，每次添加后测试iOS端状态，定位触发问题的具体事件。
  3. 针对问题事件，逐步添加回调逻辑，找到导致崩溃的代码片段。
• 检查权限配置：确认manifest中是否声明了必要权限，比如browser.tabs.onUpdated需要tabs权限，iOS Safari对权限的校验更严格。
• 对比桌面端差异：参考Apple官方文档，对比iOS与macOS Safari的MV3特性支持列表，重点关注Service Worker生命周期、API可用性的差异。

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