明明碰撞Mesh Collider，RaycastHit却无法检测到任何物体

常见修复手段 #

• 开启Mesh Collider的Convex属性：ProBuilder生成的网格默认多为非凸结构，射线检测对非凸Mesh Collider的支持存在限制，勾选Mesh Collider组件的Convex选项，这是最直接的解决办法。
• 完成Mesh烘焙：在ProBuilder工具栏执行Tools > ProBuilder > Bake Mesh，确保使用的是烘焙后的静态网格，避免临时网格导致碰撞检测失效。
• 校准射线参数：
  • 确认rayLength数值足够覆盖检测范围，避免因射线过短遗漏碰撞体。
  • 在Scene视图开启Gizmos，检查zAxisOriginA、zAxisOriginB等射线起点是否处于正确位置，防止被自身碰撞体遮挡。
• 添加Layer过滤：在射线检测中指定目标层，减少无关碰撞体干扰，示例代码如下：

  int targetLayer = 1 << LayerMask.NameToLayer("Obstacle");
  Physics.Raycast(zAxisOriginA, direction, out hit, rayLength, targetLayer);
  

• 替换为基础碰撞体：如果网格形状规则，直接用Box Collider替代Mesh Collider，既能提升检测可靠性，也能优化性能。

代码优化示例 #

原代码存在重复逻辑，可简化并增强严谨性：

bool CanMove(Vector3 direction)
{
    int obstacleLayer = 1 << LayerMask.NameToLayer("Obstacle");
    Vector3[] rayOrigins = direction.z != 0 ? new[] { zAxisOriginA, zAxisOriginB } : new[] { xAxisOriginA, xAxisOriginB };
    
    foreach (var origin in rayOrigins)
    {
        if (Physics.Raycast(origin, direction, out RaycastHit hit, rayLength, obstacleLayer))
        {
            Debug.Log($"检测到碰撞：{hit.collider.name}");
            return false;
        }
    }
    return true;
}

内容的提问来源于stack exchange，提问作者Nush