Chrome扩展后台页面运行正常，调用getBackgroundPage()报错如何解决？

这个报错的核心原因是Chrome扩展Manifest版本的差异：getBackgroundPage()仅适用于Manifest V2的背景页，而Manifest V3已改用无DOM环境的Service Worker，不存在传统意义上的背景页window对象。以下是针对性解决方案：

情况1：使用Manifest V2 #

确保你的manifest.json中正确配置背景页：

• 若使用单独的背景页面文件：

  "background": {
    "page": "background.html"
  }
  

  （需在background.html中引入你的后台脚本）

• 若直接指定后台脚本：

  "background": {
    "scripts": ["background.js"],
    "persistent": false
  }
  

  配置完成后，chrome.runtime.getBackgroundPage()即可正常获取背景页的window对象。

情况2：使用Manifest V3 #

Manifest V3已移除背景页，getBackgroundPage()不再适用，需替换为以下通信方式：

方式1：消息传递 #

在弹窗中发送消息：

// popup.js
const response = await chrome.runtime.sendMessage({ action: "fetchData" });
console.log("来自Service Worker的响应：", response);

在Service Worker（background.js）中监听并响应：

// background.js
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  if (message.action === "fetchData") {
    sendResponse({ data: "这是Service Worker返回的数据" });
  }
});

方式2：共享存储 #

如果仅需共享数据，可使用chrome.storage API：

// 弹窗中存储数据
await chrome.storage.local.set({ key: "value" });

// Service Worker中读取数据
const { key } = await chrome.storage.local.get("key");

同时确认Manifest V3的background配置正确：

"background": {
  "service_worker": "background.js"
}

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