AdguardBrowserExtension脚本重复注入问题分析与解决方案

问题现象

在Adguard浏览器扩展（版本4.3.46）与Firefox浏览器（版本124）的组合环境中，用户发现当添加特定脚本规则后，该规则会在页面中被多次执行。具体表现为：当用户添加example.com#%#//scriptlet("log", "hello")规则后，访问目标网站并在浏览器窗口最小化一段时间后，控制台会显示该规则被重复执行多次。

技术背景

浏览器扩展的事件页面（Event Page）是扩展的核心部分，它遵循"按需唤醒"的原则。当扩展需要处理某些事件时，浏览器会唤醒事件页面；当不活动时，浏览器会将其休眠以节省资源。在Firefox中，这种机制可能导致扩展在特定条件下被反复唤醒。

问题根源

经过分析，该问题主要由以下因素导致：

1. 事件页面生命周期管理：当浏览器窗口最小化时，Firefox可能会将扩展的事件页面置于休眠状态。当用户重新激活窗口时，事件页面会被重新唤醒，导致脚本重新注入。

2. 脚本注入机制缺陷：扩展当前的脚本注入逻辑没有充分考虑事件页面唤醒场景，缺乏有效的"已注入"状态标记，导致每次唤醒都视为首次注入。

3. 内存泄漏隐患：如用户反馈所示，这个问题还可能导致严重的内存泄漏问题。每次重新注入脚本都会在页面中创建新的执行上下文，而旧的上下文可能未被正确清理。

解决方案

针对这个问题，开发团队实施了以下改进措施：

1. 注入状态追踪：在扩展中增加了脚本注入状态的追踪机制，确保同一脚本在同一页面只注入一次。

2. 事件页面优化：改进了事件页面的唤醒处理逻辑，避免不必要的脚本重新注入。

3. 资源清理机制：增强了脚本卸载和资源回收功能，防止因重复注入导致的内存累积。

影响范围

该问题主要影响：

• Firefox浏览器用户
• 使用脚本规则（特别是scriptlet）的用户
• 长时间保持浏览器打开并频繁切换窗口状态的用户

用户建议

对于遇到类似问题的用户，建议：

1. 更新到修复该问题的扩展版本
2. 对于复杂脚本规则，考虑使用内容脚本替代方案
3. 定期刷新长时间打开的页面以释放潜在的内存占用

技术启示

这个案例展示了浏览器扩展开发中的几个重要考量点：

1. 事件页面生命周期管理的重要性
2. 脚本注入的幂等性设计
3. 内存泄漏的预防和检测

通过这个问题的解决，Adguard扩展在稳定性和资源管理方面得到了显著提升。