uBlockOrigin过滤器导致荷兰语网站内容被误屏蔽的技术分析

问题现象

在开发阶段的荷兰国际象棋网站schaakfabriek.sitefly.dev上，开发者发现某些博客文章内容被意外隐藏。具体表现为：

1. 特定分类下的文章无法显示
2. 访问广告分类页面时出现完全空白的情况
3. 仅在使用uBlock Origin扩展时出现此问题

技术原因

经过分析，这是由于uBlock Origin的荷兰语过滤器列表(NL list)的规则导致的。该列表包含针对荷兰语"广告"(advertentie)相关内容的屏蔽规则。

关键点在于：

• 网站使用了"advertentie"(广告)作为分类名称
• 该分类对应的HTML元素会被自动添加category-advertentie类名
• uBlock Origin的NL列表包含针对此类名的屏蔽规则

解决方案

对于网站开发者或需要查看被屏蔽内容的用户，可以通过添加以下例外规则解决：

schaakfabriek.sitefly.dev#@#.category-advertentie

这条规则会针对特定域名下的广告分类元素禁用屏蔽功能。

技术建议

1. 开发环境处理：在开发阶段，建议暂时禁用广告相关过滤器或使用白名单规则
2. 命名规范：避免使用可能触发过滤器的敏感词汇作为分类/ID名称
3. 测试验证：开发过程中应在启用常见广告拦截器的情况下进行兼容性测试
4. 用户指导：正式上线后可考虑为用户提供如何添加例外的指导说明

总结

这个案例展示了广告拦截器与网站开发之间的常见冲突。理解过滤器的工作原理有助于开发者提前规避问题，或在出现问题时快速定位原因。对于使用uBlock Origin等工具的网站，建议在开发周期中加入广告拦截兼容性测试环节。