Unity将2D Physics.OverlapCircle改为3D OverlapSphere后无法阻挡移动问题求助

核心逻辑错误 #

你当前的碰撞检测失效是代码判断逻辑错误导致的，Physics.OverlapSphere 接口本身完全可以满足3D网格移动的碰撞检测需求。

• Physics.OverlapSphere 无论是否检测到碰撞体，返回值都是Collider数组类型，永远不会为null：未检测到碰撞时返回长度为0的空数组，检测到碰撞时返回包含对应碰撞体的数组。
• 你代码中的if (colliders != null) 条件永远为真，相当于碰撞检测完全未生效，所以玩家可以穿过障碍物。

修复方法 #

将碰撞判断条件改为判断数组长度是否为0即可，你也可以直接用更适配当前场景的Physics.CheckSphere接口简化代码：

// 修改后的水平输入判断逻辑示例
if (Mathf.Abs(Input.GetAxisRaw("Horizontal")) == 1f) 
{
    Vector3 targetPos = movePoint.position + new Vector3(Input.GetAxisRaw("Horizontal"), 0, 0);
    // CheckSphere直接返回bool，不需要处理数组，更适合只判断是否有碰撞的场景
    if (!Physics.CheckSphere(targetPos, 0.4f, whatStopsMovement))
    {
        movePoint.position = targetPos;
    }
}
// 垂直输入逻辑同理修改即可

需额外排查的配置问题 #

如果修改代码后仍未生效，请检查以下配置：

• 障碍物必须挂载3D碰撞体（如BoxCollider、SphereCollider，不要用2D的Collider2D组件），且不能勾选IsTrigger选项
• 公开字段whatStopsMovement的层级掩码必须选中障碍物对象所在的层级，不要选中玩家自身所在的层级
• 检测半径可以适当调大（比如从0.2f改为0.4f），避免半径过小漏检碰撞体。

其他可行实现方案 #

• 如果你做的是严格对齐的固定网格游戏，可以提前在网格数据中标记障碍物格子的坐标，移动前直接查询目标格子是否为障碍物，不需要依赖物理检测，性能更高且不会出现物理漏判问题
• 如果你需要支持非网格的自由移动，可以使用Unity自带的CharacterController组件，调用其Move方法即可自动处理3D碰撞阻挡。

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