Chrome扩展Manifest V3中部分Tab无ID？生产环境报错排查

问题背景 #

Chrome扩展生产环境中，后台脚本处理getGlobalTabID消息时，部分场景出现_sender.tab.id不存在的报错。该消息由注入所有HTTPS站点的content script发送，但理论上content script仅运行在有Tab ID的标签页中，疑惑为何会出现无ID的情况。

用户提供代码 #

后台监听代码 #

chrome.runtime.onMessage.addListener(async (request: any, _sender: any, _sendResponse: any) => {
  if (request.message === 'getGlobalTabID') {
    _sendResponse({
      globalTabID: ServiceWorkerGlobals.globalTabID,
      currentTabID: _sender.tab.id
    });
  }
});

Content Script发送代码 #

chrome.runtime.sendMessage({message: 'getGlobalTabID'}, async response => { })

可能的原因 #

• 标签页处于销毁/关闭流程中：用户关闭标签页时，content script不会立即终止，仍可能执行发送消息的逻辑。此时该标签页的ID已被Chrome回收，_sender.tab可能缺失id属性，甚至_sender.tab本身为undefined。
• 特殊HTTPS内置页面：部分Chrome内置HTTPS页面（如Web Store相关页面、账号同步页面）可能允许content script注入，但这类页面的Tab对象存在特殊处理，导致id属性未正常暴露。
• 标签页未完成初始化：标签页刚启动、未完成加载的阶段，content script可能已被注入并发送消息，此时Tab的ID尚未被Chrome分配或同步到后台上下文。

解决方案 #

在后台处理消息时增加安全判断，避免直接访问可能不存在的属性：

chrome.runtime.onMessage.addListener(async (request: any, _sender: any, _sendResponse: any) => {
  if (request.message === 'getGlobalTabID') {
    const currentTabID = _sender.tab?.id;
    _sendResponse({
      globalTabID: ServiceWorkerGlobals.globalTabID,
      currentTabID: currentTabID ?? null // 可根据业务逻辑替换为合适的默认值
    });
  }
});

同时可在content script中控制发送时机，确保页面加载完成后再发送消息：

document.addEventListener('DOMContentLoaded', () => {
  chrome.runtime.sendMessage({message: 'getGlobalTabID'}, async response => { });
});

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