Chrome扩展修改请求头不生效，硬编码正常异步读取失效如何解决？

• chrome.storage.sync.get是异步API，你在它的回调函数中修改请求头时，外层的webRequest监听函数已经提前将未修改的请求头返回给浏览器，修改操作赶不上请求发送流程，所以不会生效。硬编码时所有操作同步执行，修改能在返回前完成，因此功能正常。
• 你尝试的Promise+await方案不生效，是因为Manifest V2版本的webRequest.onBeforeSendHeaders监听函数不支持异步返回，必须同步返回修改结果。

Manifest V2 适配方案 #

通过全局变量预存UA配置，避免在请求触发时异步读取存储，保证所有请求头修改操作同步完成：

// 全局缓存自定义UA，默认值和存储读取默认值对齐
let customUA = "Non-Set";

// 扩展初始化时读取存储中的UA配置
chrome.storage.sync.get({pua: "Non-Set"}, res => {
  customUA = res.pua;
});

// 监听UA配置变更，实时更新缓存
chrome.storage.onChanged.addListener((changes, areaName) => {
  if (areaName === "sync" && changes.pua) {
    customUA = changes.pua.newValue;
  }
});

// webRequest监听直接使用缓存值，全同步操作
chrome.webRequest.onBeforeSendHeaders.addListener(function (data){
  for (let i = 0; i < data.requestHeaders.length; i++) {
    if (data.requestHeaders[i].name === "User-Agent") {
      data.requestHeaders[i].value = customUA;
      break;
    }
  }
  return {requestHeaders: data.requestHeaders}
}, {urls: ["<all_urls>"]}, ["requestHeaders", "blocking", "extraHeaders"])

你需要确认manifest.json中已经申请了对应权限：

"permissions": [
  "storage",
  "webRequest",
  "webRequestBlocking",
  "<all_urls>"
]

Manifest V3 适配方案 #

Manifest V3中个人扩展无法使用webRequest的blocking权限，推荐使用declarativeNetRequest API实现请求头修改，在UA配置变更时动态更新规则即可：

// 更新UA修改规则
function updateUARule(newUA) {
  const rule = {
    id: 1,
    priority: 1,
    action: {
      type: "modifyHeaders",
      requestHeaders: [
        {header: "User-Agent", operation: "set", value: newUA}
      ]
    },
    condition: {
      urlFilter: "*",
      resourceTypes: ["main_frame", "sub_frame", "xmlhttprequest", "media", "image", "stylesheet", "script"]
    }
  }
  chrome.declarativeNetRequest.updateDynamicRules({
    removeRuleIds: [1],
    addRules: [rule]
  })
}

// 初始化时读取配置生成规则
chrome.storage.sync.get({pua: "Non-Set"}, res => updateUARule(res.pua))

// 监听配置变更更新规则
chrome.storage.onChanged.addListener((changes, area) => {
  if (area === 'sync' && changes.pua) {
    updateUARule(changes.pua.newValue)
  }
})

对应manifest.json需要添加权限：

"permissions": [
  "storage",
  "declarativeNetRequest"
],
"host_permissions": [
  "<all_urls>"
]

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