Manifest V3下Chrome declarativeNetRequest能否完全替代webRequest及规则配置疑问

Chrome 的 declarativeNetRequest 无法完全替代 Manifest V2 时代的阻塞式 webRequest 能力，你提到的两个带自定义运行时逻辑的场景，恰好是 declarativeNetRequest 设计上的能力边界，不是配置疏漏导致的无法实现。

• 关于静态规则的能力边界
  declarativeNetRequest 的设计逻辑是把网络拦截规则前置、做静态化匹配，核心是绕开 service worker 频繁休眠的问题，因此不支持在请求拦截的同步阻塞阶段插入自定义 JS 逻辑。所有由它触发的重定向、请求头修改动作，都只能是规则预先定义好的固定映射，没法在规则命中的拦截节点实时执行你写的 custom_function 做动态决策。

对应两个业务场景的适配方案 #

1. 重定向前需要执行自定义方法的场景

   原有逻辑：匹配到目标 URL 后，先从 URL 中提取 id 执行业务逻辑，再将请求重定向到指定地址。
   这类需要在拦截链路中插入同步自定义逻辑的需求，在 Manifest V3 下无法用 declarativeNetRequest 实现替代——DNR 的重定向动作是规则命中后直接执行，没有预留插入自定义代码的执行节点。如果强行绕开做异步监听，会出现逻辑执行顺序不可控、service worker 提前休眠导致业务逻辑漏执行的问题，最终只能通过非阻塞的 webRequest 配合 service worker 回调实现，但注意在 MV3 下普通扩展拿不到全局的阻塞式 webRequest 权限，这类场景需要走合规的扩展权限申请流程。

2. 根据浏览器环境动态修改请求头的场景

   原有逻辑：给匹配的 XHR 请求追加自定义 User-Agent 头，值为当前浏览器 UA 拼接固定版本号后缀。
   这里要分两种情况适配：

   • 如果拼接的后缀是固定值，可以直接在 DNR 规则里写死静态的 modifyHeaders 动作实现，完全不需要跑自定义逻辑
   • 如果需要实时读取当前浏览器的 navigator.userAgent 动态拼接值，DNR 本身不支持读取运行时的环境变量，正确实现方式是在 service worker 初始化时先拼好完整的自定义头字符串，再通过 chrome.declarativeNetRequest.updateDynamicRules 动态更新规则的修改头动作，不需要调用阻塞式 webRequest。

你遇到的“extensionPath 不支持捕获组占位、regexSubstitution 不能指向扩展页面”的问题，是 DNR 的规则设计本身的限制，不是你写法的问题，拆解下来有两个核心原因：

• 首先你写的 "regexFilter": "google.com*" 本身不符合 DNR 的规则语法：DNR 的 regexFilter 是标准 ECMAScript 正则格式，不是 MV2 webRequest 兼容的 glob 通配符规则，原来写法里的 * 会被解析为“重复0次或多次的前一个字符m”，完全达不到匹配 google.com 域名的预期效果。
• 其次 DNR 的重定向参数是严格分离设计的，两个字段的能力边界互斥：
  • redirect 动作下的 extensionPath 字段，不支持任何正则捕获组的替换占位符（比如 \0/\1），它只接受纯静态的扩展内路径字符串，不会做任何字符串替换操作
  • redirect 动作下的 regexSubstitution 字段，只能填写合法的完整 URL，不能直接写相对路径的 spinner.html，且它和 extensionPath 不能同时在一条规则里混用。
    正确的实现方式有两种：

1. 如果需要把原始请求的完整 URL 作为参数传递给 spinner.html，可以直接在 regexSubstitution 中写完整的扩展 origin 地址搭配捕获组占位符，示例规则：

   {
     "id": 1,
     "priority": 1,
     "action": {
       "type": "redirect",
       "redirect": {
         "regexSubstitution": "chrome-extension://<你的扩展ID>/spinner.html?url=\\0"
       }
     },
     "condition": {
       "regexFilter": "^https?://(www\\.)?google\\.com.*$",
       "resourceTypes": ["main_frame"]
     }
   }
   

   注意 JSON 格式下正则的捕获组占位符需要写双反斜杠转义，\\0 对应正则匹配到的完整原始 URL。
2. 如果不想在静态规则里硬编码扩展 ID，可以在 service worker 运行时通过 chrome.runtime.getURL("spinner.html") 拿到扩展内页面的完整地址，再动态拼接到替换模板里，通过 updateDynamicRules 注册规则即可。

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