Chrome扩展MV3：background.js向所有标签页content.js发消息失败

错误原因分析 #

你遇到的Uncaught (in promise) Error: Could not establish connection. Receiving end does not exist.错误，核心原因通常是这几点：

• 部分标签页（比如浏览器内置的chrome://页面、扩展自身后台页）不匹配content_scripts的matches规则，content.js根本没注入进去
• 标签页还没加载完成，content.js的消息监听还没初始化
• Manifest V3里chrome.tabs.sendMessage返回Promise，你没处理失败情况，导致未捕获的Promise异常

具体修复方案 #

1. 过滤可注入的标签页，处理Promise错误

修改background.js，只向符合http/https协议的标签页发送消息（对应<all_urls>中能注入content脚本的范围），同时捕获发送失败的异常：

if (message.action === "globalResetTimer") {
  chrome.tabs.query({ url: ["http://*/*", "https://*/*"] }, (tabs) => {
    tabs.forEach(tab => {
      chrome.tabs.sendMessage(tab.id, { action: "resetTimer" })
        .catch(err => {
          console.log(`标签页 ${tab.id} 无法接收消息:`, err);
        });
    });
  });
}

2. 可选：确保标签页加载完成后再发送

如果需要保证content脚本完全初始化，可以在查询标签页时加上status: "complete"：

chrome.tabs.query({ 
  url: ["http://*/*", "https://*/*"], 
  status: "complete" 
}, (tabs) => {
  // 同上发送消息逻辑
});

3. 检查content脚本的完整性

确保resetInactiveTimer函数存在并正确定义，避免因函数缺失导致隐性问题：

// content.js
// 先定义函数
function resetInactiveTimer() {
  console.log("定时器已重置");
  // 补充你的业务逻辑
}

chrome.runtime.onMessage.addListener((message, _sender) => {
  if (message.action === "resetTimer") {
    resetInactiveTimer();
  }
});

4. 完善manifest权限配置

确认manifest里添加了tabs权限，否则chrome.tabs.query可能无法正常工作：

"content_scripts": [
  {
    "matches": ["<all_urls>"],
    "js": ["content.js"],
    "run_at": "document_start"
  }
],
"background": {
  "service_worker": "background.js"
},
"permissions": ["tabs"]

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