MapLibre GL JS 中空心多边形点击查询的问题分析与解决方案

问题背景

在使用MapLibre GL JS进行地理信息可视化时，开发者发现了一个关于空心多边形（带孔洞的多边形）点击查询的异常行为。当用户点击空心多边形的孔洞部分时，queryRenderedFeatures方法仍然会返回该多边形特征，这与预期行为不符。

问题重现

该问题出现在MapLibre GL JS 5.3.0及以上版本中。具体表现为：

1. 绘制一个带孔洞的多边形（即空心多边形）
2. 点击该多边形的孔洞部分
3. 调用queryRenderedFeatures方法查询点击位置的要素
4. 方法返回了该空心多边形的特征，而实际上点击位置并不在多边形填充区域内

技术分析

经过深入分析，发现这个问题源于2025年5月的一个代码变更。该变更原本是为了解决多边形查询相关的问题，但意外引入了这个回归错误。

核心问题在于MapLibre GL JS内部对多边形几何结构的处理方式。在底层实现中：

1. 填充图层（fill layer）使用polygonIntersectsMultiPolygon方法进行要素查询
2. 查询时，点击点被视为"多边形"，而特征几何被视为"多多边形"
3. 系统将特征几何错误地处理为3个独立的多边形（每个环一个），而不是一个包含3个环的单个多边形

更深层次的原因是intersection_tests.ts文件中"多边形"的定义与GeoJSON规范不一致。在MapLibre中，多边形被定义为单个环的数组，而GeoJSON规范中多边形应该是环的数组的数组（即可以包含多个环，包括外环和内环/孔洞）。

解决方案

开发团队经过讨论后决定：

1. 首先回滚导致问题的变更（#5590）
2. 未来重新设计"多多边形"的处理逻辑，确保与GeoJSON规范完全兼容

这种分步解决方案的原因是直接修改多边形定义会引发大量连锁反应，需要谨慎处理。

对开发者的建议

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 降级到5.3.0之前的版本
2. 在应用层添加额外的点击点验证逻辑
3. 等待官方发布修复版本

总结

这个问题展示了地理信息系统中几何处理的重要性，特别是当涉及复杂几何类型（如带孔洞的多边形）时。MapLibre团队已经确认问题并制定了修复计划，体现了开源项目对问题响应的及时性和透明度。

对于依赖此类功能的开发者，建议关注MapLibre的更新日志，及时获取问题修复的最新进展。同时，这也提醒我们在处理地理空间数据时，要特别注意各种格式和规范之间的差异。