AdGuard浏览器扩展MV3版本中Service Worker导致规则失效问题分析

问题背景

AdGuard浏览器扩展是一款广受欢迎的广告拦截工具，其MV3(Manifest V3)版本在Chrome 127浏览器环境中出现了一个与Service Worker相关的兼容性问题。当目标网站使用Service Worker技术时，扩展的某些过滤规则会意外失效。

问题现象

在测试环境中，当用户访问一个使用了Service Worker技术的示例页面时，首次加载时AdGuard的过滤规则（包括CSS隐藏规则和JS注入规则）能够正常工作。然而，当Service Worker完成注册后，页面刷新会导致这些规则完全失效。

具体表现为：

1. 首次访问googlechrome.github.io/samples/service-worker/prefetch-video/index.html时：
   • CSS隐藏规则(##body)生效，页面内容被隐藏
   • JS注入规则(#%#alert(1))生效，弹出警告框
2. Service Worker注册完成后刷新页面：
   • 所有规则不再生效
   • 页面正常显示
   • 无警告框弹出

技术分析

Service Worker的工作原理

Service Worker是一种在浏览器后台运行的脚本，它充当网络代理的角色，可以拦截和处理网络请求。它独立于网页运行，即使页面关闭后仍可继续运行，这使得网站能够实现离线访问、后台同步等高级功能。

MV3扩展架构变化

Chrome的MV3扩展规范对扩展的工作方式进行了重大调整，其中最重要的是：

• 移除了后台页面(background page)的概念
• 引入了Service Worker作为扩展的后台处理机制
• 对内容脚本(content scripts)的执行环境进行了更严格的控制

问题根源

在AdGuard MV3扩展中，当网页使用Service Worker时，可能出现以下情况：

1. 执行时机冲突：网页的Service Worker和扩展的Service Worker可能在某些情况下产生执行顺序的冲突
2. 请求拦截失效：网页Service Worker可能接管了网络请求，导致扩展的过滤规则无法正确应用
3. DOM修改被覆盖：Service Worker控制的页面可能在扩展完成DOM修改后再次更新内容
4. 执行环境隔离：MV3对扩展脚本执行环境的限制可能导致某些注入脚本无法在Service Worker控制的页面中正确执行

解决方案

AdGuard团队在收到问题报告后迅速响应，经过深入分析后确定了问题原因并实施了修复方案。修复主要涉及以下几个方面：

1. 执行顺序调整：优化扩展Service Worker的执行时机，确保在网页Service Worker之前完成必要的处理
2. 请求监听增强：改进对Service Worker拦截请求的处理逻辑，确保过滤规则能够正确应用
3. DOM操作策略：采用更可靠的DOM修改策略，防止被Service Worker控制的页面覆盖
4. 注入机制改进：优化JS注入的执行方式，确保在Service Worker环境下也能可靠运行

技术启示

这一问题的解决为开发者提供了几个重要的技术启示：

1. MV3兼容性测试：开发MV3扩展时需要特别关注与网页Service Worker的交互情况
2. 执行环境理解：深入理解浏览器扩展与网页Service Worker的执行顺序和交互机制
3. 防御性编程：在可能被Service Worker控制的页面中，需要采用更健壮的规则应用策略
4. 测试覆盖范围：扩展测试应包含各种Service Worker使用场景，确保功能的稳定性

总结

AdGuard团队对MV3扩展中Service Worker导致规则失效问题的快速响应和解决，展现了其对产品质量的高度重视。这一案例也提醒开发者，在浏览器技术不断演进的过程中，需要持续关注新特性与现有功能的兼容性问题，确保为用户提供稳定可靠的服务。