Chrome扩展Manifest V3下chrome.webRequest.onAuthRequired代理授权异常问题

问题背景 #

开发了基于Manifest V3的Chromium扩展，通过chrome.proxy.settings配置代理，依赖chrome.webRequest.onAuthRequired实现代理服务器自动授权。当前存在以下异常：

• 多数页面刷新后可正常自动授权，但Chrome应用商店等部分谷歌服务页面会弹出系统级的用户名/密码输入窗口
• 临时缓解方式：跳转至其他页面刷新后返回，弹窗会消失并完成授权；浏览器重启后（未禁用扩展）弹窗可能重现，点击「取消」即可完成授权；偶尔随机页面也会出现该弹窗，点击「取消」同样能完成授权
• 已尝试切换blocking和asyncBlocking模式，问题未解决

当前授权代码 #

function authRequired() {
    chrome.webRequest.onAuthRequired.addListener(
      async function (details, callback) {
        const credentials = await new Promise(resolve => {
          chrome.storage.local.get(['selectedIPAddress'], function (result) {
            resolve(JSON.parse(result.selectedIPAddress));
          });
        });
        callback({
          authCredentials: {
             username: credentials.username,
            password: credentials.password
          }
        });
      },
      { urls: ['<all_urls>'] },
      ['asyncBlocking']
    )
}
authRequired()

可能原因分析 #

1. 谷歌服务请求特殊处理：部分谷歌内部服务的请求可能绕过webRequest监听逻辑，直接触发系统级认证弹窗
2. 异步凭证获取延迟：在认证回调中异步读取chrome.storage.local，可能因响应超时导致Chrome触发系统弹窗
3. 请求类型覆盖不全：默认监听规则可能未覆盖谷歌服务的部分子资源请求，导致这些请求未触发自动授权

解决方案建议 #

1. 提前缓存凭证，避免异步延迟 #

将凭证在扩展启动时提前读取到内存，认证回调直接使用缓存，减少异步操作带来的响应延迟：

// 全局缓存凭证
let cachedCredentials = null;

// 扩展初始化时读取存储中的凭证
chrome.storage.local.get(['selectedIPAddress'], (result) => {
  if (result.selectedIPAddress) {
    cachedCredentials = JSON.parse(result.selectedIPAddress);
  }
});

// 监听存储变化，实时更新缓存
chrome.storage.onChanged.addListener((changes) => {
  if (changes.selectedIPAddress) {
    cachedCredentials = JSON.parse(changes.selectedIPAddress.newValue);
  }
});

function authRequired() {
  chrome.webRequest.onAuthRequired.addListener(
    (details, callback) => {
      if (cachedCredentials) {
        // 直接使用缓存的凭证完成授权
        callback({
          authCredentials: {
            username: cachedCredentials.username,
            password: cachedCredentials.password
          }
        });
      } else {
        // 凭证未就绪时取消当前认证，触发重新请求
        callback({ cancel: true });
      }
    },
    // 明确覆盖所有请求类型，避免遗漏子资源
    { urls: ['<all_urls>'], types: ['main_frame', 'sub_frame', 'stylesheet', 'script', 'image', 'font', 'object', 'xmlhttprequest', 'ping', 'csp_report', 'media', 'websocket', 'other'] },
    ['blocking']
  );
}
authRequired();

2. 完善权限与监听规则 #

• 确保manifest.json中已声明必要权限："webRequest"、"webRequestBlocking"、"proxy"、"storage"以及"<all_urls>"
• 明确指定types字段覆盖所有请求类型，避免谷歌服务的子资源请求未被监听

3. 处理认证重试逻辑 #

当凭证未就绪时返回{ cancel: true }，触发Chrome重新发起请求，此时缓存的凭证大概率已加载完成，可完成自动授权

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