uBlockOrigin/uAssets项目中的Google Tag Manager白名单修复案例

问题背景

在uBlockOrigin/uAssets项目中，用户报告了一个关于越南PTIT教育网站(slink.ptit.edu.vn)的页面显示问题。当用户登录账户并访问该网站时，整个页面会呈现空白状态，无法显示任何内容。经过技术团队分析，发现这是由于uBlock Origin的过滤规则过度拦截了Google Tag Manager(gtag.js)脚本导致的。

技术分析

Google Tag Manager是Google提供的一款标签管理系统，广泛应用于网站分析和营销工具的集成。许多网站依赖GTM来加载核心功能脚本，当这类脚本被广告拦截工具误拦截时，可能会导致网站功能异常。

在本案例中，slink.ptit.edu.vn网站使用了GTM来加载必要的JavaScript代码。uBlock Origin默认的过滤规则将gtag.js识别为可能的跟踪脚本而进行了拦截，这导致网站无法正常初始化，从而呈现空白页面。

解决方案

技术团队提出了一个精确的白名单规则来解决此问题：

@@||googletagmanager.com/gtag/js$script,domain=slink.ptit.edu.vn

这条规则具有以下技术特点：

1. 使用@@前缀表示这是一个例外规则(白名单)
2. 精确匹配googletagmanager.com域名下的gtag/js路径
3. 限定只对script类型的资源生效
4. 通过domain参数将适用范围限制在slink.ptit.edu.vn网站

这种设计既解决了网站功能问题，又保持了uBlock Origin对其他网站GTM脚本的拦截能力，体现了精准过滤的理念。

实施效果

用户反馈在应用此白名单规则后，网站功能完全恢复正常。这表明：

1. 该网站确实依赖GTM加载关键脚本
2. 白名单规则定位准确，没有过度放宽过滤条件
3. 解决方案既保障了用户体验，又维护了隐私保护的基本原则

技术启示

这个案例展示了广告拦截工具在实际使用中可能遇到的功能性冲突问题，以及如何通过精确的例外规则来平衡隐私保护和网站功能。对于网站开发者而言，这也提示了过度依赖第三方服务可能带来的可用性风险。

对于uBlock Origin用户，当遇到类似问题时，可以参考此案例的思路：先识别被拦截的关键资源，然后通过精确的白名单规则恢复必要的功能，同时保持对其他不必要跟踪脚本的拦截。