Unity3D Player角色地面检测（Ground Check）失效问题求助

我有一个名为Player的角色对象，已添加Collider、Animator组件，挂载了RigidBody，角色的Collider是启用Convex的Mesh Collider。我试图通过检测角色与标签为Ground的平面的碰撞，判断角色是否处于地面（isGrounded）状态，但挂载在Player上的以下脚本无法正确检测——当角色站在Ground平面上时，isGrounded始终为false。我已尝试调整boxSize、distance等参数，问题仍未解决。

原脚本代码：

void Update()
    {
        if(Physics.BoxCast(transform.position, boxSize, -player.up, out hit, Quaternion.Euler(collider.eulerAngles), distance, mask, QueryTriggerInteraction.Ignore))
        {
            if(hit.collider.tag == "Ground")
            {
                isGrounded = true;
                groundNormal = hit.normal;
            }
            else
            {
                isGrounded = false;
                groundNormal = Vector3.up;                          // 未接触地面时重力方向保持向下
            }
        }
        else
        {
            isGrounded = false;
            groundNormal = Vector3.up;
        }
    }

问题原因与修复方案 #

1. 检测起点与旋转参数错误

• 直接用transform.position作为BoxCast起点，可能和角色Collider的实际碰撞区域偏移，导致漏检地面。建议改用Collider的边界中心作为起点，或向下偏移到角色底部附近。
• Quaternion.Euler(collider.eulerAngles)会错误转换局部欧拉角，应该直接使用角色的Transform旋转，保证检测盒子和角色姿态一致。

2. 方向与变量未验证

确认player变量已正确赋值为角色的Transform，若未赋值，直接用-Vector3.up作为向下检测的方向更稳妥。

3. Layer Mask与参数设置

• 检查mask是否包含Ground所在的Layer，避免过滤掉目标层。
• boxSize应设置为角色Collider的半尺寸（如collider.bounds.extents），distance设为极小值（如0.1f），防止检测范围过大或过小。

修正后的BoxCast检测代码

public Collider playerCollider; // 在Inspector面板拖拽角色的Mesh Collider到此处
public LayerMask groundLayerMask;
private bool isGrounded;
private Vector3 groundNormal;
private RaycastHit hit;
public float groundCheckDistance = 0.1f;

void Update()
{
    // 默认设为未接地状态
    isGrounded = false;
    groundNormal = Vector3.up;

    // 以Collider边界中心为起点，缩小XZ检测范围避免误碰侧面物体
    Vector3 castOrigin = playerCollider.bounds.center;
    Vector3 halfExtents = playerCollider.bounds.extents;
    halfExtents.x *= 0.8f;
    halfExtents.z *= 0.8f;

    if(Physics.BoxCast(castOrigin, halfExtents, -Vector3.up, out hit, transform.rotation, groundCheckDistance, groundLayerMask, QueryTriggerInteraction.Ignore))
    {
        if(hit.collider.CompareTag("Ground"))
        {
            isGrounded = true;
            groundNormal = hit.normal;
        }
    }
}

更稳定的替代方案：碰撞事件检测

使用Unity的碰撞事件直接检测接触，无需手动射线/盒子检测，稳定性更高：

private bool isGrounded;
private Vector3 groundNormal;

void OnCollisionStay(Collision collision)
{
    foreach(ContactPoint contact in collision.contacts)
    {
        // 法线与向上方向夹角小于45度时判定为地面
        if(Vector3.Dot(contact.normal, Vector3.up) > 0.7f && collision.collider.CompareTag("Ground"))
        {
            isGrounded = true;
            groundNormal = contact.normal;
            return;
        }
    }
}

void OnCollisionExit(Collision collision)
{
    if(collision.collider.CompareTag("Ground"))
    {
        isGrounded = false;
        groundNormal = Vector3.up;
    }
}

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