AdGuard浏览器扩展中$permissions规则的行为异常分析

问题背景

在AdGuard浏览器扩展的使用过程中，发现了一个关于$permissions规则行为的异常现象。这个规则本应只对文档(document)类型的请求生效，但实际上却影响了其他类型的请求，导致某些网站(如twitch.tv)的功能出现异常。

技术细节

$permissions是AdGuard过滤规则中的一个特殊修饰符，用于控制网页的权限请求行为。根据官方文档描述，不带任何内容类型修饰符的$permissions规则应当仅匹配内容类型为document的请求。

然而，在实际测试中发现，类似$permissions=whatever=()这样的规则会被错误地应用到非文档类型的请求上，特别是影响了Brave浏览器中twitch.tv网站的聊天功能。

问题复现

要复现这个问题，可以按照以下步骤操作：

1. 在AdGuard过滤器中添加测试规则：$permissions=whatever=()
2. 打开浏览器开发者工具
3. 访问twitch.tv网站

在某些情况下，可能需要先禁用"AdGuard跟踪保护过滤器"和"AdGuard快速修复过滤器"才能观察到该现象。

影响分析

这种异常行为会导致以下问题：

1. 功能破坏：某些网站功能(如实时聊天)可能无法正常工作
2. 性能影响：不必要的权限检查会增加浏览器负担
3. 过滤规则失效：规则的实际行为与预期不符，可能导致过滤效果不准确

解决方案

AdGuard团队已经确认这是一个bug，并在版本5.0-mv3 patch 3中修复了这个问题。修复后，$permissions规则将严格按照文档描述的行为工作：

• 带内容类型修饰符的规则：按修饰符指定的类型匹配
• 不带内容类型修饰符的规则：仅匹配document类型请求

技术建议

对于过滤规则开发者，建议：

1. 明确指定内容类型修饰符，确保规则按预期工作
2. 测试规则时，检查不同类型请求的匹配情况
3. 及时更新AdGuard扩展，获取最新的bug修复

对于普通用户，如果遇到类似问题：

1. 检查是否使用了自定义的$permissions规则
2. 暂时禁用相关规则测试是否是规则导致的问题
3. 更新到最新版本的AdGuard扩展

总结

这个案例展示了过滤规则引擎中一个细微但重要的行为差异。虽然表面上看起来是一个简单的匹配规则问题，但实际上可能影响网站的核心功能。AdGuard团队快速响应并修复了这个问题，体现了对产品质量的重视。作为用户或开发者，理解这些技术细节有助于更好地使用和创建过滤规则。