使用Declarative Net Request设置User-Agent无效问题求助

问题排查与修正步骤 #

1. 补全manifest.json的规则关联配置 #

你当前的manifest仅声明了权限，但未指定规则文件的加载路径，浏览器无法识别你的规则。需要添加declarative_net_request字段关联规则文件：

{
  "manifest_version": 3,
  "name": "UA修改工具",
  "version": "1.0",
  "permissions": [
    "declarativeNetRequestWithHostAccess",
    "declarativeNetRequestFeedback"
  ],
  "host_permissions": [
    "<all_urls>"
  ],
  "declarative_net_request": {
    "rule_resources": [
      {
        "id": "ruleset_1",
        "enabled": true,
        "path": "rules.json" // 替换为你的规则文件实际路径
      }
    ]
  }
}

2. 修正规则的URL匹配逻辑 #

你当前的urlFilter: "http*"匹配逻辑错误，仅会匹配类似httpabc.com这类异常URL，无法覆盖正常的HTTP/HTTPS请求。改为以下两种写法之一：

• 匹配所有请求：

[
  {
    "id": 1,
    "priority": 10, // 适当调高优先级避免被其他规则覆盖
    "action": {
      "type": "modifyHeaders",
      "requestHeaders": [
        {
          "header": "User-Agent",
          "operation": "set",
          "value": "success"
        }
      ]
    },
    "condition": {
      "urlFilter": "*"
    }
  }
]

• 精确匹配HTTP/HTTPS协议：

[
  {
    "id": 1,
    "priority": 10,
    "action": {
      "type": "modifyHeaders",
      "requestHeaders": [
        {
          "header": "User-Agent",
          "operation": "set",
          "value": "success"
        }
      ]
    },
    "condition": {
      "urlFilter": "http://*/*|https://*/*"
    }
  }
]

3. 验证规则加载状态 #

通过浏览器扩展面板确认规则是否生效：

• 打开chrome://extensions/，开启开发者模式
• 进入你的扩展详情页，找到「Declarative Net Request」选项
• 查看规则是否成功加载，无冲突或错误提示

额外注意 #

• 确保规则文件路径与manifest配置一致，文件为标准JSON格式
• 若存在其他同类型扩展，可提高priority值（范围1-10000）保证规则优先执行
• 部分浏览器对内部API请求的User-Agent修改有限制，这类场景无法生效

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