Chrome扩展URL拦截跳转问题：如何让background.js在后台自动运行？

修复后台脚本触发逻辑 #

你的background.js仅在点击扩展图标时运行，核心是manifest配置未正确声明权限和后台运行规则，不同manifest版本配置如下：

Manifest V3（官方当前推荐版本） #

manifest.json必填配置项示例：

{
  "manifest_version": 3,
  "name": "URL拦截扩展",
  "version": "1.0",
  "permissions": ["declarativeNetRequest"],
  "host_permissions": ["<all_urls>"],
  "background": {
    "service_worker": "background.js"
  }
}

• declarativeNetRequest是V3官方推荐的网络拦截权限，性能更高
• host_permissions配置你需要拦截的站点范围，<all_urls>代表拦截所有站点请求
• V3的后台service worker是事件驱动的，不需要手动设置常驻，触发对应网络事件时会自动唤醒，无需用户点击扩展图标

Manifest V2（旧版本兼容） #

manifest.json必填配置项示例：

{
  "manifest_version": 2,
  "name": "URL拦截扩展",
  "version": "1.0",
  "permissions": ["webRequest", "webRequestBlocking", "<all_urls>"],
  "background": {
    "scripts": ["background.js"],
    "persistent": true
  }
}

• persistent: true保证后台脚本长期驻留运行，不会自动休眠

实现URL拦截重定向逻辑 #

方案1：声明式拦截（V3推荐，页面加载前触发） #

直接在background.js中注册拦截规则，示例为拦截所有百度的访问重定向到必应：

chrome.runtime.onInstalled.addListener(() => {
  // 先清除旧规则避免重复注册
  chrome.declarativeNetRequest.updateDynamicRules({
    removeRuleIds: [1],
    addRules: [{
      id: 1,
      priority: 1,
      action: {
        type: 'redirect',
        redirect: { url: 'https://www.bing.com' }
      },
      condition: {
        urlFilter: '*://*.baidu.com/*',
        resourceTypes: ['main_frame']
      }
    }]
  })
})

该规则会在页面请求发起前触发，无需等待页面加载。

方案2：事件式拦截（V2/V3通用，支持复杂逻辑） #

如果需要做动态判断、接口请求等复杂逻辑，可以用webRequest API：

chrome.webRequest.onBeforeRequest.addListener(
  (details) => {
    // 自定义拦截逻辑
    if (details.url.includes('baidu.com')) {
      return { redirectUrl: 'https://www.bing.com' }
    }
  },
  { urls: ["<all_urls>"] },
  ["blocking"]
)

注意事项 #

• 安装扩展后需要在扩展管理页，给对应扩展开启对应站点的访问权限，否则拦截规则不会生效
• 如果仅需要拦截特定站点，把host_permissions和拦截规则里的URL匹配范围缩小到对应站点即可，不需要申请全站点权限

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