Godot-Jolt物理引擎中射线投射问题的分析与解决

问题背景

在Godot 4.2.2版本中使用Godot-Jolt物理引擎时，开发者发现射线投射(Raycast)功能出现异常。具体表现为：当场景中存在大量碰撞体时，部分射线无法正确检测到碰撞，即使这些射线与已正确检测到碰撞的其他射线位置相近。

问题复现与验证

为验证这一问题，开发者创建了一个测试项目：在场景中生成网格状碰撞盒阵列，然后通过射线投射检测碰撞并"绘制"这些碰撞盒。测试结果显示，在启用Jolt物理引擎时，只能检测到+X方向的部分碰撞盒，形成一个半圆形图案；而禁用Jolt后，则可以正确检测所有碰撞盒。

进一步测试发现，这个问题不仅出现在编辑器中的射线投射，也出现在程序化生成的垂直向下射线投射中。

技术分析

经过深入分析，发现问题根源在于Jolt物理引擎的broadphase(广相)优化机制。具体表现为：

1. 未调用OptimizeBroadPhase方法：在编辑器环境下，物理系统从未调用Jolt的JPH::PhysicsSystem::OptimizeBroadPhase()方法，导致物理查询遍历的是一个极其低效的quadtree广相结构。

2. 栈溢出风险：由于广相结构未经优化，当处理大量物体时，会耗尽Jolt物理引擎预设的128大小的固定栈空间，导致结果出现随机性错误。

3. 运行时与编辑器的差异：在正常运行时，物理系统会在第一个物理tick时自动重建/优化广相结构；但在编辑器环境下，物理模拟实际上从未被步进(step)，因此广相结构始终保持未优化状态。

解决方案

开发团队提出了几种可能的解决方案，并最终选择了最稳健的实现方式：

1. 计数器方案：维护一个计数器，记录自上次物理更新以来新增的物体数量。当该数量接近危险阈值(128×3)时，触发广相优化调用。

2. 优化时机选择：将优化检查放在每次物理查询开始时执行，而非在添加物体时立即执行。这样可确保在编辑器环境下按需优化，同时避免在正常运行时产生不必要的优化开销。

3. 状态重置机制：每当执行OptimizeBroadPhase或PhysicsSystem::Update时，重置计数器，确保系统保持最新状态。

实现细节

最终实现的关键点包括：

• 在物理查询前检查新增物体数量
• 智能判断何时需要优化广相结构
• 确保不影响正常游戏运行时的性能
• 避免在编辑器环境下产生明显的延迟

版本更新与修复

该修复已包含在Godot-Jolt 0.13.0版本中，主要针对Godot 4.3版本。开发者需要注意：

1. 此修复需要升级到Godot 4.3版本
2. 0.13.0稳定版已发布，建议从beta版本升级的用户及时更新
3. 该修复显著改善了在编辑器环境下处理大量物理物体时的射线投射准确性

技术启示

这个案例展示了物理引擎中一些容易被忽视的实现细节：

1. 编辑器与运行时的差异：许多物理引擎优化假设场景会定期更新，但编辑器环境可能打破这些假设。

2. 性能与正确性的平衡：最初为了性能考虑省略的优化调用，最终却导致了功能性问题。

3. 渐进式解决方案的价值：相比于复杂的延迟添加方案，简单的计数器机制提供了足够稳健的解决方案。

通过这个问题的解决，Godot-Jolt物理引擎在处理大量物体时的射线投射可靠性得到了显著提升，特别是在编辑器环境下的表现更加稳定。