Chrome扩展加载失败：未执行的chrome.tabs.sendMessage触发inspectedWindow错误

问题场景 #

• 后台脚本里有一段启动阶段并未执行的代码，但仅这段代码存在就导致扩展加载失败，报错：无法读取undefined的'inspectedWindow'属性
• 把这段代码注释掉换成console.log()，脚本就能正常启动，且没有日志输出
• 启动时content script还不存在，按道理Chrome不该在消息发送前报错，而且完全搞不懂为啥会牵扯到inspectedWindow
• 把chrome.tabs.sendMessage改成chrome.runtime.sendMessage后，脚本就能正常加载，疑惑Chrome为啥会管没执行的代码

问题代码 #

try {
    chrome.tabs.sendMessage(tabId, {type: "ping"}, (response) => {
        // 暂时没用到这个回调
    });
} catch (err) {
    console.log("Tab gone?");
}

原因分析 #

1. Chrome扩展加载后台脚本时，会对顶层作用域的代码做静态检查，哪怕代码在函数里没被执行，静态分析时也可能触发API的权限或环境校验
2. chrome.tabs.sendMessage依赖tabs权限，其内部实现可能关联了inspectedWindow的上下文检测，如果扩展没声明tabs权限，或者刚启动的后台环境不满足tabs API的检测条件，静态检查阶段就会直接抛出错误
3. chrome.runtime.sendMessage属于更基础的runtime API，权限要求低，静态检测逻辑更宽松，所以不会触发这个问题

解决方案 #

• 检查manifest.json，确保已经声明了tabs权限
• 把这段代码封装到函数内部，避免顶层作用域的静态检测触发错误（哪怕函数没被调用，封装后静态分析不会深入到函数内部做API校验）
• 如果不需要和特定标签页通信，直接用chrome.runtime.sendMessage替代

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