Godot Jolt物理引擎中关于无效变换的警告解析

问题现象

在使用Godot 4.3版本配合Godot Jolt物理引擎时，开发者可能会遇到一个特定的警告信息："_rest_info: get_rest_info was passed an invalid transform"。这个警告指出引擎接收到了一个无效的变换参数，具体表现为不支持(1.000000, 1.200000, 1.000000)这样的非均匀缩放比例。

技术背景

在3D物理引擎中，物体的变换(Transform)包含了位置、旋转和缩放三个主要组成部分。Godot Jolt物理引擎对物体的缩放变换有特定要求：

1. 均匀缩放限制：Jolt物理引擎更倾向于处理均匀缩放（即x、y、z三个轴的缩放比例相同）
2. 非均匀缩放处理：当遇到非均匀缩放时，引擎会自动将其转换为近似均匀缩放（如示例中的(1.066667, 1.066667, 1.066667)）

常见触发场景

根据开发经验，这个问题通常出现在以下情况：

1. ShapeCast3D节点使用：当ShapeCast3D节点或其父节点被施加了非均匀缩放时
2. 物理空间查询：使用PhysicsDirectSpaceState3D进行形状相交检测时传入的变换包含非均匀缩放
3. 复合碰撞体：某些复杂碰撞体形状组合可能导致缩放问题

解决方案

要解决这个问题，开发者可以采取以下步骤：

1. 检查场景树：仔细检查所有ShapeCast3D节点及其父节点的缩放属性
2. 统一缩放比例：确保所有物理相关节点的缩放是均匀的（x=y=z）
3. 代码审查：检查所有使用PhysicsDirectSpaceState3D进行物理查询的代码，确保传入的变换参数缩放正确
4. 层级结构调整：考虑将需要非均匀缩放的对象与物理对象分离到不同的节点层级

最佳实践

为避免此类问题，建议：

1. 物理对象独立：将物理模拟相关的节点放在独立的节点分支中，避免继承不必要的变换
2. 视觉与物理分离：使用不同的节点处理视觉表现和物理模拟，各自应用合适的变换
3. 缩放一致性：在设计阶段就规划好缩放策略，保持物理对象的缩放一致性

总结

Godot Jolt物理引擎对变换参数有特定要求，特别是缩放部分。开发者在使用ShapeCast或物理查询功能时，应当注意保持变换的均匀性，以避免引擎自动转换带来的潜在问题。通过合理的场景结构设计和缩放管理，可以有效地避免这类警告的出现。