Chrome扩展webRequestBlocking转declarativeNetRequest广告拦截失效如何解决

核心问题及修复步骤 #

• 1. 替换已废弃的domains字段
  Manifest V3中condition.domains已被弃用，需替换为initiatorDomains指定请求发起方为youtube站点，避免规则不被匹配：

// 原配置
"domains" : ["youtube.com"]
// 替换为
"initiatorDomains" : ["youtube.com", "www.youtube.com"]

如果需要匹配请求的目标域名，可以额外增加requestDomains字段。

• 2. 补全拦截的资源类型
  当前仅拦截4类资源，遗漏了Youtube视频广告对应的media类型资源，需在resourceTypes中添加：

"resourceTypes": [
    "script", "image", "xmlhttprequest", "sub_frame", "media"
]

• 3. 优化正则规则写法
  你当前的正则包含多余的捕获括号，部分规则匹配范围不全，可做如下优化：

  • 移除所有正则里不必要的括号，RE2语法不需要额外包裹捕获组
  • 转义正则里的点号，例如(adservice.google.)改为adservice\.google\.，避免点号匹配任意字符导致误判
  • 可增加"isUrlFilterCaseSensitive": false到condition中，忽略大小写匹配提升命中率

• 4. 调高规则优先级
  默认优先级1较低，容易被其他更高优先级的规则覆盖，可调整为priority: 2或更高。

• 5. 检查manifest权限配置
  确保manifest.json中已添加必要权限：

"permissions": [
    "declarativeNetRequest",
    "declarativeNetRequestFeedback" // 可选，用于调试查看规则匹配情况
],
"host_permissions": [
    "*://*.youtube.com/*",
    "*://*.doubleclick.net/*",
    "*://*.googleadservices.com/*"
    // 嫌逐个配置麻烦可直接写"<all_urls>"覆盖所有广告域名
]

调试方法 #

如果修改后仍有广告，可通过以下方式排查规则匹配情况：

1. 打开扩展管理页面，开启对应扩展的「开发者模式」
2. 点击扩展详情页的「查看视图」下的背景页/Service Worker
3. 执行以下代码查看规则匹配日志：

chrome.declarativeNetRequest.getMatchedRules({}, console.log)

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