Chrome Extension Manifest V3自定义User Agent未生效问题排查

你的Chrome扩展无法设置自定义User-Agent，核心缺失两个关键配置：

1. 缺少必要的权限声明 #

在Manifest V3中，修改User-Agent这类受保护的请求头，仅声明declarativeNetRequest权限是不够的，需要添加declarativeNetRequestWithHostAccess权限——这个权限允许扩展通过动态规则修改跨域请求的请求头。

修改后的manifest.json权限部分：

"permissions": [
  "declarativeNetRequest",
  "declarativeNetRequestWithHostAccess"
],

2. 规则中建议明确指定资源类型 #

虽然Chrome默认的resourceTypes包含大部分请求类型，但显式指定可以确保规则覆盖所有需要修改UA的场景，避免因默认范围限制导致规则不生效。

修改background.js中的规则condition部分：

condition: {
  urlFilter: '<all_urls>',
  resourceTypes: ["main_frame", "sub_frame", "xmlhttprequest", "script", "image", "media", "websocket", "other"]
}

额外优化建议 #

为了快速排查问题，建议在调用updateDynamicRules时添加错误捕获，方便确认规则是否成功加载：

chrome.declarativeNetRequest.updateDynamicRules(rules)
  .then(() => console.log("规则更新成功"))
  .catch(err => console.error("规则更新失败:", err));

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