Manifest V3版Chrome扩展无法调用webRequest接口问题求助

核心错误原因 #

Manifest V3 中，chrome.webRequest API 仅允许在service worker（后台服务工作者）中调用，内容脚本没有访问该API的权限，所以会出现「属性不存在」的错误，也无法捕获网络请求。

注：你提到V3无background脚本是误解——V3只是将V2的background页面替换为service worker，两者功能类似但运行机制更轻量化。

修复步骤 #

1. 修改manifest.json，添加service worker配置

在原有配置基础上，新增background字段指定service worker脚本：

{
  "manifest_version": 3,
  ...
  "permissions": [
    "webRequest",
    "webRequestBlocking",
    "<all_urls>"
  ],
  "content_scripts": [
    {
      "js": ["scripts/content.js"],
      "css": ["styles.css"],
      "matches": ["<the site>"],
      "run_at": "document_idle"
    }
  ],
  "background": {
    "service_worker": "background.js"
  }
}

2. 将webRequest监听器移到service worker脚本中

新建background.js文件，写入监听器代码（注意必须指定urls参数，否则监听器不会触发）：

chrome.webRequest.onBeforeRequest.addListener(
  (request) => {
    console.log(request);
  },
  { urls: ["<all_urls>"] }, // 匹配所有URL，可根据需求缩小范围
  [] // 若需要阻塞请求，传入["blocking"]；无需阻塞则留空
);

3. 查看service worker的日志

内容脚本的日志在页面控制台查看，但service worker的日志需要单独打开：

• 打开Chrome扩展管理页面（chrome://extensions/）
• 找到你的扩展，点击「Service Worker」右侧的「检查」按钮，即可查看监听器的请求日志。

额外说明 #

• service worker是事件驱动的，不能使用DOM相关API，仅支持Chrome扩展API和部分标准Web API
• 如果需要在内容脚本和service worker之间传递数据，可使用chrome.runtime.sendMessage和chrome.runtime.onMessage进行通信

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