Manifest V3扩展中declarativeNetRequest动态规则无法删除求助

问题原因分析 #

你的代码存在两个核心问题：

1. 在同一个chrome.declarativeNetRequest.updateDynamicRules调用中，同时执行添加ID为1000的规则和删除ID为1000的规则，Chrome会将这个操作处理为原子性的「先删除再添加」，导致规则始终被保留。
2. Manifest V3的动态规则是持久化存储的，即使重启浏览器、重新加载扩展，只要没有显式调用删除逻辑，规则会一直存在于扩展的存储中。

解决方案 #

要彻底删除动态规则，需要拆分操作逻辑，并在合适的时机触发删除：

1. 分离添加与删除操作 #

不要在同一个updateDynamicRules调用中操作同一个规则ID，先添加规则，待目标请求完成后再单独调用删除逻辑。

2. 扩展启动时清理残留规则 #

在扩展启动（或安装/更新）时，主动清理旧规则，避免残留规则干扰新逻辑。

3. 监听请求完成后立即删除规则 #

针对「仅需修改特定请求Cookie」的场景，监听目标请求的完成事件，一旦请求处理完毕就删除规则，确保规则仅生效一次。

代码示例 #

基础的添加/删除函数 #

// 添加动态规则
function addCookieModifyRule(targetUrl, cookieValue) {
  chrome.declarativeNetRequest.updateDynamicRules({
    addRules: [{
      id: 1000,
      priority: 100,
      action: {
        type: "modifyHeaders",
        requestHeaders: [{
          header: "cookie",
          operation: "set",
          value: cookieValue
        }]
      },
      condition: {
        urlFilter: targetUrl,
        resourceTypes: ["csp_report", "font", "image", "main_frame", "media", "object", "other", "ping", "script", "stylesheet", "sub_frame", "webbundle", "websocket", "webtransport"]
      }
    }],
    removeRuleIds: []
  }, () => {
    if (chrome.runtime.lastError) {
      console.error("添加规则失败:", chrome.runtime.lastError);
      return;
    }
    console.log("规则添加成功");
    // 绑定请求完成监听，触发删除
    bindRequestCompleteListener(targetUrl);
  });
}

// 删除动态规则
function removeCookieModifyRule() {
  chrome.declarativeNetRequest.updateDynamicRules({
    addRules: [],
    removeRuleIds: [1000]
  }, () => {
    if (chrome.runtime.lastError) {
      console.error("删除规则失败:", chrome.runtime.lastError);
      return;
    }
    console.log("规则删除成功");
    // 验证删除结果
    chrome.declarativeNetRequest.getDynamicRules(rules => {
      console.log("当前剩余动态规则:", rules);
    });
  });
}

监听请求完成并删除规则 #

function bindRequestCompleteListener(targetUrl) {
  const requestListener = (details) => {
    // 匹配目标请求URL
    if (details.url.includes(targetUrl)) {
      removeCookieModifyRule();
      // 移除监听，避免重复触发
      chrome.webRequest.onCompleted.removeListener(requestListener);
    }
  };

  // 注册请求完成监听
  chrome.webRequest.onCompleted.addListener(
    requestListener,
    { urls: [targetUrl] },
    []
  );
}

扩展启动时清理残留规则 #

在background.js中添加启动监听：

// 浏览器启动时清理
chrome.runtime.onStartup.addListener(removeCookieModifyRule);

// 扩展安装/更新时清理
chrome.runtime.onInstalled.addListener(removeCookieModifyRule);

调用示例 #

当满足条件时触发规则添加：

if (condition) {
  addCookieModifyRule("https://your-target-url.com/*", "Modified cookie value 2");
}

注意事项 #

• 确保在manifest.json中声明所需权限："declarativeNetRequest"、"declarativeNetRequestWithHostAccess"（或指定host_permissions），以及"webRequest"（如果使用请求监听）。
• 动态规则的ID要唯一，避免与其他规则冲突。

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