Chrome扩展升级至Manifest V3后失效，请求排查解决

1. 外部页面chrome.runtime未定义的核心原因 #

服务器端页面报错Cannot read properties of undefined (reading 'sendMessage')，本质是Chrome未允许该页面访问扩展的chrome.runtime接口——这是Manifest V2迁移到V3时极易遗漏的点：V3中必须显式配置externally_connectable来指定可与扩展通信的外部站点，你的V3配置里缺少了这个关键字段。

2. 修复步骤 #

步骤1：补全Manifest V3的externally_connectable配置 #

修改manifest.json，添加和V2一致的外部通信规则：

{
  "manifest_version": 3,
  "name": "Close all tabs",
  "version": "1.0",
  "description": "Close all tabs extension",
  "permissions": ["tabs"],
  "host_permissions": ["http://xxxxx:9080/*"],
  "background": {"service_worker": "closetabs.js"},
  "externally_connectable": {
    "matches": ["http://XXXXXX:*/*"] // 与V2中的匹配规则保持一致
  }
}

步骤2：修复Service Worker代码的命名空间错误 #

你的closetabs.js第一行缺少chrome.前缀，导致无法监听外部消息：
原错误代码：

runtime.onMessageExternal.addListener((request, sender, sendResponse) => {

修改为：

chrome.runtime.onMessageExternal.addListener((request, sender, sendResponse) => {

步骤3：优化异步逻辑（可选但推荐） #

当前代码的Promise链式调用存在变量作用域污染问题，建议改用async/await让逻辑更清晰：

chrome.runtime.onMessageExternal.addListener(async (request, sender, sendResponse) => {
  console.log("message received", request);

  // 获取当前活跃标签（若后续需使用）
  const activeTabs = await chrome.tabs.query({ currentWindow: true, active: true });
  const curtab = activeTabs[0]?.id;

  // 处理非活跃标签关闭逻辑
  const inactiveTabs = await chrome.tabs.query({ currentWindow: true, active: false });
  const wDomainsArr = request.wDomains;

  for (const tab of inactiveTabs) {
    let keepTab = false;
    for (const domain of wDomainsArr) {
      if (tab.url.includes(domain)) {
        keepTab = true;
        break;
      }
    }
    if (!keepTab) {
      await chrome.tabs.remove(tab.id);
    }
  }

  // 打开指定标签页
  if (request.tab1Open) {
    await chrome.tabs.create({ url: request.tab1Open });
  }
  if (request.tab2Open) {
    await chrome.tabs.create({ url: request.tab2Open });
  }
});

注：将result变量移至循环内部，避免跨循环污染；用await确保异步操作按顺序执行。

步骤4：验证外部调用的扩展ID #

确认服务器端代码中的extensionId是V3扩展的正确ID——升级V3后，若未保留V2的密钥，扩展ID会变化，可在Chrome扩展管理页（chrome://extensions/）开启开发者模式后查看。

3. 调试建议 #

• 查看Service Worker日志：在扩展管理页点击"Service Worker"的"Inspect"，通过DevTools确认是否收到外部消息。
• 检查外部页面控制台：确认extensionId是否正确，是否存在其他权限类报错。

内容的提问来源于stack exchange，提问作者Raz Guille Rosman