Chrome扩展webRequest API运行不稳定，收集的请求域名数组偶发为空如何解决？

问题原因 #

• 事件过滤逻辑错误：你当前设置了details.parentFrameId !== -1的判断规则，parentFrameId为-1对应页面顶层主框架的请求，这条规则直接把主站的请求全部排除，仅会收集iframe子框架的请求，页面没有iframe时自然会出现收集结果为0、数量不稳定的问题。
• 内存存储不可靠：Chrome扩展的后台运行上下文（Manifest V3的Service Worker、Manifest V2的非持久后台页）会被浏览器自动回收释放，你存在内存变量includedUrls里的数据会随着上下文销毁直接清空，导致运行一段时间后数组变空。
• Promise滥用无意义：webRequest.onBeforeRequest是持续触发的事件监听器，不是一次性异步操作，你用Promise包装但从未调用resolve()，不仅毫无作用还会导致内存泄漏，也不会对外层调用返回任何结果。
• 监听器重复绑定风险：如果webRequestsChecking函数被多次调用，会重复添加同一个事件监听器，同一个请求会触发多次回调，可能引发数据重复处理、逻辑错乱的问题。
• 域名提取逻辑不可靠：手动用split('/')切割URL提取域名的方式容错率极低，遇到带端口、带特殊路径的URL很容易提取失败。

修复方案 #

1. 修正事件过滤规则：删除错误的parentFrameId判断，可新增判断排除扩展自身发出的请求，避免收集到无关的扩展内部请求。
2. 改用持久化存储：将收集到的域名存入chrome.storage.local，即使后台上下文被回收，数据也不会丢失，重启后可直接读取恢复。
3. 移除无效Promise包装：直接在扩展启动入口（后台脚本顶层）绑定一次监听器即可，不要重复调用绑定逻辑。
4. 优化域名提取逻辑：使用原生URL构造函数提取域名，兼容所有合法URL格式，稳定性更高。
5. 可选补充：如果只需要收集当前激活标签页的域名，可新增tabId过滤规则，避免多个标签页的请求混杂导致数据不符合预期。

修复后示例代码 #

// 仅在扩展启动时执行一次，不要重复调用
function initWebRequestListener() {
  chrome.webRequest.onBeforeRequest.addListener(
    async (details) => {
      try {
        // 排除扩展自身发出的请求
        if (details.initiator === chrome.runtime.id) return
        // 可靠提取域名
        const domain = new URL(details.url).hostname
        // 从持久化存储读取已有列表
        const { includedUrls = [] } = await chrome.storage.local.get('includedUrls')
        // 去重后更新存储和状态
        if (!includedUrls.includes(domain)) {
          const updatedUrls = [...includedUrls, domain]
          await chrome.storage.local.set({ includedUrls: updatedUrls })
          setIncludedUrls(updatedUrls)
          console.log(updatedUrls, '更新后的域名列表')
        }
      } catch (err) {
        console.error('请求处理失败：', err)
      }
    },
    { urls: ['<all_urls>'] },
    []
  )
}

// 如需清空收集的域名可调用该方法
async function clearCollectedDomains() {
  await chrome.storage.local.remove('includedUrls')
  setIncludedUrls([])
}

manifest权限配置补充 #

Manifest V2 #

"permissions": ["webRequest", "<all_urls>", "storage"]

Manifest V3 #

"permissions": ["webRequest", "storage"],
"host_permissions": ["<all_urls>"]

运行截图 #

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