Manifest V3 Chrome扩展报错：无法建立连接，接收端不存在

问题详情 #

开发Manifest V3版本的Chrome扩展时，出现报错：

Uncaught (in promise) Error: Could not establish connection. Receiving end does not exist.

当前background.js已能正常向content.js发送消息，但上述报错仍未消除，已尝试多种教程及网络方案无果。

报错上下文 #

关联文件：scripts/background.js

堆栈跟踪 #

scripts/background.js:0 (anonymous function)

涉及代码文件 #

• manifest.json
• scripts/background.js
• scripts/contentScript.js

排查与解决要点 #

• 确认content script注入覆盖范围
  检查manifest.json中content_scripts的matches规则是否包含所有需要交互的页面URL，避免因页面不匹配导致content script未注入，引发接收端不存在的报错。
• 提前注册消息监听
  确保contentScript.js中的chrome.runtime.onMessage.addListener（或chrome.tabs.onMessage）在脚本加载后立即执行，不要嵌套在DOMContentLoaded等异步回调中，防止background发起请求时接收端尚未就绪。
• 控制消息发送时机
  若background在页面未加载完成时触发消息发送（比如service worker刚唤醒就发消息），会导致接收端不存在。可通过chrome.tabs.query获取目标tab的status为complete后再发送，或监听chrome.tabs.onUpdated事件在页面加载完成后执行发送逻辑。
• 校验消息发送的目标tab
  确认background.js中调用chrome.tabs.sendMessage时传入的tabId正确，避免因tab ID错误发送到未注入content script的页面。
• 处理service worker生命周期问题
  Manifest V3的background service worker会因闲置销毁，若发送消息时service worker刚被唤醒，可能出现时序问题。可先通过空的chrome.runtime.sendMessage唤醒service worker，再执行消息发送逻辑。

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