Chrome扩展Manifest V3中declarativeNetRequest移除origin请求头不生效如何排查

• 开启规则匹配日志：打开chrome://extensions/，找到SPO Helper扩展，点击「详情」开启开发者模式，点击「检查视图」后的Service Worker打开调试面板，在控制台执行以下代码开启匹配跟踪：

// 开启规则匹配计数角标
chrome.declarativeNetRequest.setExtensionActionOptions({displayActionCountAsBadgeText: true})
// 监听规则匹配事件
chrome.declarativeNetRequest.onRuleMatchedDebug.addListener((info) => {
  console.log('规则匹配成功：', info)
})

执行后刷新SharePoint页面发起接口请求，查看控制台是否输出匹配日志，有输出则规则已触发，无输出则规则条件未命中。

• 主动查询匹配规则：在Service Worker控制台执行以下代码，可直接查询指定页面命中的规则列表：

// 替换为你测试SharePoint页面的标签ID
const testTabId = 123
chrome.declarativeNetRequest.getMatchedRules({tabId: testTabId}, (rules) => {
  console.log('当前页面命中的规则：', rules)
})

你当前的配置存在两个核心错误，是规则未生效的主要原因：

1. rules.json中condition.domains字段填写的是扩展ID，该字段的作用是匹配请求发起方所在页面的域名，并不识别扩展ID；你要匹配发往SharePoint的请求，应该使用requestDomains字段匹配目标接口的域名。
2. resourceTypes仅包含了main_frame和sub_frame，仅命中页面框架加载请求，SharePoint REST API属于XHR/Fetch请求，对应的类型是xmlhttprequest和fetch，这类请求完全不会命中你当前的规则。

修正后的rules.json参考：

[
    {
        "id": 1,
        "priority": 999,
        "action": {
            "type": "modifyHeaders",
            "requestHeaders": [
                {
                    "header": "origin",
                    "operation": "remove"
                }
            ]
        },
        "condition" : {
            "requestDomains": ["sharepoint.com"],
            "resourceTypes" : ["main_frame", "sub_frame", "xmlhttprequest", "fetch"]
          }
    }
]

额外排查点 #

• 修改规则后必须在扩展管理页点击刷新按钮重载扩展，旧规则会缓存不会自动更新。
• 如果规则命中后origin仍存在，可调高规则的priority数值（数值越大优先级越高），避免被其他扩展的同类型规则覆盖。
• 确认扩展的host_permissions已覆盖所有你需要修改请求的SharePoint域名，你当前配置的https://*.sharepoint.com/可满足通用场景。

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