Unity修改Physics.OverlapSphere判断值为1后角色停止移动怎么办

Physics.OverlapSphere的检测结果包含了玩家自身的碰撞体，和教程运行环境的预期结果不一致，导致==1的判断条件恒成立，FixedUpdate执行到判断处就直接return，后续的水平移动、跳跃逻辑完全不会执行，角色因此停止移动。
导致自检测问题的常见原因有3种：

• groundCheckTransform位置配置错误：地面检测点被放在玩家自身碰撞体内部，且检测点到脚底的距离大于检测半径0.1f。这种状态下检测球会持续和玩家自身碰撞体重叠，如果全程碰不到地面碰撞体，返回的碰撞体数组长度永远为1，判断条件永久触发。教程作者的检测点是放置在玩家碰撞体外部、脚底正下方的位置，检测球不会接触自身碰撞体，站在地面时仅检测到地面碰撞体（数组长度1），悬空时无检测结果（数组长度0），逻辑可正常运行。
• 未配置检测层掩码：当前调用的Physics.OverlapSphere重载没有传入层筛选参数，默认会检测所有层的碰撞体，包含玩家自身所在层。如果教程作者提前将玩家放在独立层、检测时排除了玩家层，就不会出现自检测问题。
• 检测半径不匹配：如果你的玩家碰撞体尺寸小于教程中的参数，哪怕检测点放在碰撞体边缘，0.1f的半径也可能蹭到自身碰撞体，导致检测结果额外包含玩家自身。

在判断逻辑前加调试代码，运行后查看Console输出，确认检测结果：

Collider[] hitColliders = Physics.OverlapSphere(groundCheckTransform.position, 0.1f);
Debug.Log($"检测碰撞体数量：{hitColliders.Length}");
foreach (var col in hitColliders)
{
    Debug.Log($"命中碰撞体：{col.gameObject.name}");
}
if (hitColliders.Length == 1)
{
    return;
}

如果运行后持续输出碰撞体数量为1、命中对象为玩家自身，即可确认是自检测导致的异常。

• 基础对齐方案：调整groundCheckTransform位置
  将作为地面检测点的空物体移动到玩家碰撞体正下方，完全伸出自身碰撞体范围，比如放置在脚底往下0.03f的位置。调整后验证：玩家站在平面上时检测球刚好接触地面碰撞体，玩家悬空时检测球不接触任何碰撞体（包括玩家自身）即可。
• 稳妥优化方案：添加层掩码排除自身检测
  1. 新建名为Player的层级，将其指定给玩家物体
  2. 修改OverlapSphere调用，传入层掩码排除Player层，从代码层面避免自检测，代码如下：

// 按位取反~表示排除指定层，检测其余所有层
if (Physics.OverlapSphere(groundCheckTransform.position, 0.1f, ~LayerMask.GetMask("Player")).Length == 1)
{
    return;
}

• 逻辑补正提示：当前代码只要触发判断就会直接return，会导致地面状态下移动、跳跃逻辑都无法执行。如果调整完检测配置后出现地面无法移动、仅空中可移动的问题，将判断条件取反为if (Physics.OverlapSphere(...).Length != 1)即可，保证仅在空中时限制二段跳，地面状态下正常执行移动、跳跃逻辑。

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