Chrome扩展正则替换重定向规则无效问题求助

核心问题排查与修正 #

1. 补全Manifest V3的必要配置 #

你的重定向规则逻辑本身没问题，但缺少Manifest文件的权限声明与规则注册，这是规则不生效的核心原因。

创建或修改manifest.json，确保包含以下内容：

{
  "manifest_version": 3,
  "name": "内部网址重定向工具",
  "version": "1.0",
  "declarative_net_request": {
    "rule_resources": [
      {
        "id": "redirect_rules",
        "enabled": true,
        "path": "rules.json"
      }
    ]
  },
  "permissions": ["declarativeNetRequest"],
  "host_permissions": ["https://subdomain.domain.com/*"]
}

• declarative_net_request：注册规则文件的路径并启用规则集
• permissions：必须申请declarativeNetRequest权限才能使用重定向规则
• host_permissions：指定规则生效的域名范围，必须覆盖你要处理的网址

2. 优化规则的正则匹配（可选） #

原规则的正则表达式存在小瑕疵，调整后可避免意外匹配：

[{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "regexSubstitution": "\\0#test"
    }
  },
  "condition": {
    "regexFilter": "^https://subdomain\\.domain\\.com(/.*)?$",
    "resourceTypes": ["main_frame"]
  }
}]

• 给域名中的.添加转义符\\.（正则中.默认匹配任意字符，转义后才会匹配真实的域名点）
• (/.*)?确保同时匹配域名后带路径或不带路径的情况

3. 验证扩展加载与规则生效 #

• 打开chrome://extensions/，开启「开发者模式」，加载已解压的扩展文件夹
• 检查扩展是否有红色报错提示，若有则根据提示修正Manifest或规则
• 打开chrome://net-internals/#events，在「Filter」输入框中输入declarativeNetRequest，访问目标网址，查看是否有规则匹配的日志记录

常见坑点提醒 #

• 必须使用Manifest V3语法，Chrome当前默认不再支持V2
• host_permissions的范围要精准覆盖目标网址，比如https://subdomain.domain.com/*
• 测试时关闭其他网络类扩展，避免规则冲突

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