迁移至Safari的Manifest V3扩展：后台向弹窗发消息未接收

问题场景 #

现有Manifest V3版本Chrome扩展，移植到Safari后出现以下问题：

• 后台脚本调用chrome.runtime.sendMessage向弹窗发送消息时，弹窗无法接收，但后台无任何异常抛出
• 弹窗初始化时先注册消息监听，再发送消息通知后台“已打开”，该首次交互正常（弹窗能收到后台响应）
• 后台后续使用同一sendMessage方法发送的消息，在Safari中完全无响应（Chrome中正常）
• 已尝试添加几秒延迟避免竞态条件，问题依旧

后台发送消息代码：

try {
  chrome.runtime.sendMessage(null, myMsg, null);
} catch (err) {
  console.log("error");
  console.log(err);
}

可能的解决方向 #

1. 明确消息接收方的上下文（替代null参数）

Chrome中null作为sendMessage的第一个参数可指代扩展内所有上下文，但Safari对该参数的解析逻辑更严格。建议指定弹窗的Tab ID作为目标：

• 弹窗初始化时，通过chrome.tabs.getCurrent()获取自身Tab信息，发送给后台：

  // 弹窗侧
  chrome.tabs.getCurrent(tab => {
    chrome.runtime.sendMessage({ type: "POPUP_READY", tabId: tab.id });
  });
  

• 后台保存该Tab ID，后续发送消息时传入：

  // 后台侧
  let popupTabId = null;
  chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
    if (msg.type === "POPUP_READY") {
      popupTabId = msg.tabId;
      sendResponse({ status: "ACK" });
    }
  });
  
  // 发送消息时指定Tab ID
  if (popupTabId) {
    chrome.runtime.sendMessage(popupTabId, myMsg);
  }
  

2. 改用长连接替代一次性消息

Safari的Manifest V3对Service Worker的上下文隔离和消息通道生命周期处理与Chrome有差异，长连接（chrome.runtime.connect）更稳定：

• 弹窗侧建立连接并监听消息：

  // 弹窗侧
  const backgroundPort = chrome.runtime.connect({ name: "popup-channel" });
  backgroundPort.onMessage.addListener(message => {
    // 处理后台消息
    console.log("Popup received:", message);
  });
  
  // 通知后台连接建立
  backgroundPort.postMessage({ type: "CONNECTED" });
  

• 后台侧保存连接端口，后续通过端口发送消息：

  // 后台侧
  let popupPort = null;
  chrome.runtime.onConnect.addListener(port => {
    if (port.name === "popup-channel") {
      popupPort = port;
      // 弹窗关闭时清理端口
      port.onDisconnect.addListener(() => {
        popupPort = null;
      });
    }
  });
  
  // 发送消息
  if (popupPort) {
    popupPort.postMessage(myMsg);
  }
  

3. 排查Safari特有的兼容性问题

• 检查弹窗的消息监听是否被意外移除：确保chrome.runtime.onMessage.addListener只执行一次，且无removeListener误操作
• 开启Safari开发者工具中Service Worker的日志显示：默认情况下Safari可能不展示后台Service Worker的控制台输出，需手动在开发者工具的“控制台”面板中选择对应的Service Worker上下文查看日志
• 临时降级到Manifest V2测试：如果降级后问题消失，说明是Safari对Manifest V3消息API的兼容性bug，可考虑暂时保留V2版本或等待Safari更新修复

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