Chrome扩展按URL动态切换proxy时非预期代理报错如何解决

开发者阿泽

2026-10-19

问题根因

你的异步猜测成立：chrome.proxy.settings.set 是异步API，只有回调触发时才代表代理配置真正生效，你在onBeforeRequest的同步回调中直接调用该接口，未等待配置生效就放行请求，浏览器会沿用修改前的旧代理配置，导致规则错配。
存在全局配置竞态问题：chrome.proxy.settings是浏览器全局级别的配置项，当单页面同时发起多个不同域名的请求时，多个onBeforeRequest回调会几乎同时触发，连续调用set修改代理配置，后执行的配置会覆盖先执行的配置，最终导致部分请求拿到完全不符合预期的代理规则。

解决方案

推荐使用官方标准方案，从根本上避免异步和竞态问题：
不要动态修改全局代理配置，改为一次性设置pac_script模式的代理规则，把域名匹配逻辑直接写进PAC脚本中，不需要每次请求都调整代理配置。示例代码如下：

// 仅在扩展初始化、域名列表更新时执行一次即可
function updatePacConfig() {
  // 从localStorage读取预设的需要走代理的域名列表
  const proxyDomains = JSON.parse(localStorage.getItem('proxyDomains') || '[]')
  // 生成PAC脚本内容
  const pacScript = `
    function FindProxyForURL(url, host) {
      const targetDomains = ${JSON.stringify(proxyDomains)};
      for (let i = 0; i < targetDomains.length; i++) {
        // 支持通配符域名匹配，比如 *.example.com
        if (shExpMatch(host, targetDomains[i])) {
          return "PROXY 你的代理服务地址:端口";
        }
      }
      // 不在列表内的域名直接走直连
      return "DIRECT";
    }
  `
  // 一次性设置代理规则
  chrome.proxy.settings.set({
    value: {
      mode: "pac_script",
      pac: {
        data: pacScript
      }
    },
    scope: 'regular'
  }, () => {
    // 回调触发代表配置已生效
  })
}

// 扩展初始化时调用
updatePacConfig()
// 后续如果修改了localStorage中的代理域名列表，重新调用该函数更新PAC即可

如果一定要保留动态修改代理的逻辑，需要同时做两处修改：

将onBeforeRequest的回调改为异步逻辑，等待chrome.proxy.settings.set的回调触发后再放行请求；
增加请求队列机制，同一时间只处理一个请求的代理配置修改，避免并发修改导致的配置覆盖。该方案性能损耗极大，高并发请求场景下会出现明显的加载延迟，不推荐使用。

注意：chrome.webRequest的blocking权限在Manifest V3版本中已被declarativeNetRequest替代，新开发扩展建议优先适配Manifest V3，配合PAC脚本实现分流，稳定性和性能都更优。

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