使用declarativeNetRequest实现Amazon跳转Youtube失效问题求助

我想通过declarativeNetRequest API实现用户访问amazon.com时自动重定向到Youtube主页，调试代码时没发现报错，但功能在浏览器里不生效，求排查思路。

相关代码 #

Manifest.json #

{
  "manifest_version": 3,
  "name": "My Extension",
  "version": "1.0",
  "description": "Honours Project",
  "background": {
    "service": {
      "scripts": ["background.js"],
      "type": "service_worker",
      "persistent": true
    }
  },
  "permissions": [
    "declarativeNetRequest",
    "activeTab",
    "storage",
    "https://www.googleapis.com/",
    "webRequest",
    "*://amazon.com/*",
    "*://youtube.com/*",
    "webRequestBlocking"
  ],

  "action": {
    "default_icon": "images/zi.png",
    "default_title": "My Extension",
    "default_popup": "popup.html"
  },
  "icons": {
    "16": "images/zi.png"
  }
}

Background.js #

chrome.declarativeNetRequest.addRule({
    id: 'redirect-to-youtube',
    priority: 100,
    condition: {
      urlFilter: 'https://www.amazon.com/'
    },
    action: {
      type: 'redirect',
      redirectUrl: 'https://www.youtube.com/'
    }
  }, function() {
    if (chrome.runtime.lastError) {
      console.error(chrome.runtime.lastError.message);
      return;
    }

    // Update the dynamic rules to apply the new rule to all active tabs
    chrome.declarativeNetRequest.updateDynamicRules(function() {
      if (chrome.runtime.lastError) {
        console.error(chrome.runtime.lastError.message);
        return;
      }

      console.log('Successfully added declarative rule');
    });
  });

排查思路 #

• 权限配置修正

  • Manifest V3中，主机权限需单独放在host_permissions字段，把*://amazon.com/*和*://youtube.com/*从permissions移到新增的host_permissions数组里。
  • 移除无用权限：webRequest、webRequestBlocking和https://www.googleapis.com/（如果没用到的话），避免和declarativeNetRequest冲突。

• 规则参数修正

  • 规则ID必须是整数，把id: 'redirect-to-youtube'改成id: 1（确保ID唯一）。
  • 扩大urlFilter匹配范围：改成*://*.amazon.com/*，覆盖所有子域名和路径的访问请求。
  • 移除无效的updateDynamicRules调用：addRule已经完成动态规则添加，空调用updateDynamicRules没有作用，反而可能干扰规则生效。

• Service Worker配置修正

  • 删除background.service.persistent字段：Manifest V3不支持该参数，会导致Service Worker加载异常。
  • 检查Service Worker状态：在扩展管理页面的「Service Worker」标签或浏览器DevTools的「Application -> Service Workers」中查看是否有报错，确认服务 worker 正常激活。

• 验证规则生效状态

  • 在扩展管理页面进入「Declarative Net Request」标签，查看已添加的动态规则是否存在，确认条件和动作配置正确。
  • 打开DevTools的「Network」面板，访问amazon.com，观察请求是否被拦截重定向，查看控制台是否有相关错误日志。

• 重载扩展与清理缓存

  • 在扩展管理页面点击「重新加载」按钮，确保修改后的代码生效。
  • 清除浏览器对amazon.com的缓存，避免旧缓存导致规则不触发。

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