Chrome扩展MV3后台脚本间消息发送失败问题求助

核心原因 #

MV3的后台机制和MV2完全不同：MV2允许多个独立的后台脚本并行运行，而MV3的后台是单例Service Worker——它是单线程、事件驱动的运行环境，不支持同时运行多个独立的后台脚本实例。

你遇到的问题本质是：

• 你试图在两个"独立后台脚本"间用chrome.runtime.sendMessage传递消息，但MV3中只有主Service Worker会被实例化运行，其他所谓的"后台脚本"如果没有被导入到主Service Worker中，根本不会被执行，自然无法注册onMessage监听器接收消息。
• 前台能正常发消息给Service Worker，是因为前台页面和Service Worker属于不同的上下文，消息传递机制是跨上下文的，符合MV3的设计规范。

解决方案 #

1. 修正Manifest配置

MV3的background字段只能指定一个主Service Worker入口，并且要开启模块支持才能导入其他脚本：

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

2. 用ES模块导入工具类，直接调用方法

既然两个工具类都属于后台逻辑，没必要用消息传递，直接在同一个Service Worker上下文中调用函数即可：

// background.js（主Service Worker入口）
import { doToolAThing } from './toolA.js';
import { doToolBThing } from './toolB.js';

// 直接调用工具类方法，互相调用也没问题
doToolAThing();
doToolBThing();

// 若需要响应前台消息，统一在主脚本或导入的工具类中注册监听器
chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
  if (msg.type === 'callToolA') {
    doToolAThing();
    sendResponse({ status: 'done' });
  }
});

// toolA.js
import { doToolBThing } from './toolB.js';
export function doToolAThing() {
  // 直接调用toolB的方法，无需消息传递
  doToolBThing();
  console.log('Tool A executed');
}

3. 若必须用消息传递（特殊场景）

如果因为某些原因一定要用消息传递，需确保发送方和接收方都在同一个Service Worker上下文中：

• 在主Service Worker中导入两个工具类，确保接收方的onMessage监听器在Service Worker启动时就完成注册（不能在异步函数或延迟执行的逻辑中注册，否则Service Worker休眠后重启会丢失监听器）。

额外注意点 #

• MV3的Service Worker会在闲置时自动休眠，所有状态会丢失，所以不要依赖内存中的变量存储持久化数据，要用chrome.storage等API。
• 不要在manifest中配置多个后台脚本，这在MV3中是无效的，所有后台逻辑都要通过模块导入到主Service Worker中。

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