Godot-Jolt物理引擎中intersect_shape函数接触检测异常问题分析

问题现象

在使用Godot-Jolt物理引擎时，开发者发现intersect_shape函数在某些情况下会遗漏预期的碰撞接触点。具体表现为当查询形状与多个碰撞体相交时，返回的接触点数量少于实际相交数量，特别是在使用较大的max_result参数值时更为明显。

问题根源

经过深入分析，发现问题与Jolt物理引擎的"增强内部边缘移除"功能密切相关。该功能原本设计用于优化物理模拟过程中的接触点计算，但在特定使用场景下会产生副作用：

1. 跨物体边缘移除：内部边缘移除算法不仅作用于单个物体的内部边缘，还会错误地作用于不同物体之间的接触边缘
2. Flush调用缺失：在使用NarrowPhaseQuery进行碰撞查询时，未正确调用Flush函数，导致边缘移除算法工作异常
3. 特定几何排列：在规则网格排列的碰撞体场景中，算法会错误地移除某些特定区域的接触点

技术背景

Jolt物理引擎的InternalEdgeRemovingCollector设计初衷是优化复杂碰撞网格的内部边缘处理，主要应用于：

• 减少物理模拟中的冗余接触点
• 提高接触缓存效率
• 改善复杂网格物体的物理行为

然而，当这个功能被全局应用于所有碰撞查询时，就会导致非预期的接触点过滤行为。

解决方案

针对这一问题，开发团队提出了多层次的解决方案：

1. 代码层面修复：

   • 在碰撞查询中正确实现Flush函数调用
   • 参考CharacterVirtual类的实现方式，确保边缘移除算法正确工作

2. 配置优化：

   • 将全局的use_enhanced_internal_edge_removal设置拆分为三个独立选项：
     • 物体模拟专用
     • 碰撞查询专用
     • 运动测试专用
   • 默认禁用碰撞查询相关的边缘移除功能

3. API增强：

   • 在NarrowPhaseQuery中添加专用函数，封装正确的边缘移除处理逻辑
   • 提供更灵活的查询参数控制机制

开发者建议

对于使用Godot-Jolt的开发者，遇到类似问题时可以：

1. 临时禁用use_enhanced_internal_edge_removal设置进行问题排查
2. 对于需要精确碰撞检测的场景，考虑使用多个独立碰撞体而非复合形状
3. 关注引擎更新，及时获取修复版本
4. 对于大规模网格场景，可以探索其他优化方式，如空间分区或LOD技术

总结

这个问题展示了物理引擎中优化功能与精确性之间的权衡关系。Godot-Jolt团队通过深入分析底层机制，不仅解决了特定bug，还改进了引擎的架构设计，为开发者提供了更灵活、可靠的工具。这也提醒我们在使用物理引擎时，需要充分理解各种优化功能的应用场景和潜在影响。