如何用Chrome declarativeNetRequest动态规则集实现请求重定向并修改请求头？

开发者阿泽

2026-7-21

解决方法：匹配重定向请求并调整规则配置

要实现同时重定向请求并修改目标地址的请求头，核心是针对重定向后的请求特性调整规则配置，具体步骤如下：

1. 修改请求头规则，显式匹配重定向请求

重定向后的请求属于Chrome定义的「重定向请求」，默认不会被普通规则匹配，必须在规则中添加isRedirect: true条件，同时确保URL匹配精确、指定资源类型（你的场景是XHR请求）。

修改后的规则2代码示例：

const getBaseWriteHeaderRule = (operation = "set", value = '', redirectDomain = '') => {
  return {
    id: 2,
    priority: 2, // 优先级高于重定向规则，确保先处理头修改
    action: {
      type: "modifyHeaders",
      requestHeaders: [{
        header: "authorization",
        operation,
        value,
      }]
    },
    condition: {
      urlFilter: `https://${redirectDomain}/*`, // 加上协议，避免模糊匹配
      resourceTypes: ["xmlhttprequest"], // 仅匹配XHR请求，贴合你的场景
      isRedirect: true // 显式匹配重定向后的请求
    },
  }
}

替换输入后的实例：

{
  id: 2,
  priority: 2,
  action: {
    type: "modifyHeaders",
    requestHeaders: [{
      header: "authorization",
      operation: "set",
      value: "my-auth-value",
    }]
  },
  condition: {
    urlFilter: `https://localhost.subdomain.com:8443/*`,
    resourceTypes: ["xmlhttprequest"],
    isRedirect: true
  },
}

2. 调整规则优先级

将修改头规则的优先级设为高于重定向规则（比如重定向规则优先级1，修改头规则优先级2），确保重定向后的请求优先触发头修改逻辑。

3. 验证规则匹配

通过chrome.declarativeNetRequest.onRuleMatchedDebug监听匹配事件，确认重定向后的请求是否触发规则2。如果仍未触发，检查：

urlFilter是否完全匹配重定向后的URL（包含协议、端口）
resourceTypes是否正确对应请求类型（比如你的场景是xmlhttprequest）
权限配置是否完整（你当前的manifest.json权限已满足要求）

备选方案：使用webRequest API（适合内部扩展）

如果declarativeNetRequest方案无法满足需求，可以改用chrome.webRequest API，它能在请求全生命周期（包括重定向后）修改头，灵活性更高。

更新manifest.json权限：

{
  "permissions": [
    "webRequest",
    "webRequestBlocking",
    "<all_urls>"
  ]
}

在background service worker中添加逻辑：

// 处理重定向
chrome.webRequest.onBeforeRequest.addListener(
  (details) => {
    if (details.url.startsWith('https://public.subdomain.com/')) {
      const newUrl = details.url.replace('https://public.subdomain.com/', 'https://localhost.subdomain.com:8443/');
      return { redirectUrl: newUrl };
    }
  },
  { urls: ["https://public.subdomain.com/*"] },
  ["blocking"]
);

// 修改重定向后的请求头
chrome.webRequest.onBeforeSendHeaders.addListener(
  (details) => {
    if (details.url.startsWith('https://localhost.subdomain.com:8443/')) {
      // 移除原有Authorization头（可选）
      details.requestHeaders = details.requestHeaders.filter(h => h.name.toLowerCase() !== 'authorization');
      // 添加新的Authorization头
      details.requestHeaders.push({ name: 'authorization', value: 'my-auth-value' });
      return { requestHeaders: details.requestHeaders };
    }
  },
  { urls: ["<all_urls>"] },
  ["blocking", "requestHeaders"]
);

这个方案无需依赖动态规则集，直接通过代码处理请求，适合内部使用的扩展场景。

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