Unity中CapsuleCollider2D落地时误触发左右射线碰撞的问题

触地时IsOnWall误判的原因 #

当物体高速下落触地时，CapsuleCollider2D.Cast 检测左右方向会误判地面为墙壁，核心原因有两点：

• 胶囊体形状特性：胶囊碰撞体底部是弧形结构，挤压接触地面时，左右方向投射的胶囊范围会与地面碰撞体产生重叠，触发碰撞检测。
• 物理引擎碰撞响应：物体下落惯性会导致胶囊体与地面产生短暂嵌入或位置偏移，此时哪怕很小的 wallDistance，左右方向的Cast也会扫到地面碰撞体，让IsOnWall返回true。

解决方案 #

1. 分层检测，区分地面与墙壁 #

给地面和墙壁设置不同物理层，修改过滤条件让接地检测仅针对地面层，触墙检测仅针对墙壁层：

// 初始化过滤层
groundFilter.layerMask = LayerMask.GetMask("Ground");
wallFilter.layerMask = LayerMask.GetMask("Wall");

// 检测逻辑
IsGrounded = CapsuleCollider2D.Cast(Vector2.down, groundFilter, groundHits, groundDistance) > 0;
IsOnWall = CapsuleCollider2D.Cast(transform.right, wallFilter, wallHits, wallDistance) > 0;

2. 通过碰撞法线验证触墙有效性 #

墙壁的碰撞法线接近水平（y分量趋近于0），地面法线则垂直向上（y分量趋近于1），利用这一特征过滤误判：

IsOnWall = false;
if (CapsuleCollider2D.Cast(transform.right, wallFilter, wallHits, wallDistance) > 0)
{
    foreach (var hit in wallHits)
    {
        // 法线接近水平则判定为有效触墙
        if (Mathf.Abs(hit.normal.y) < 0.1f)
        {
            IsOnWall = true;
            break;
        }
    }
}

3. 修复翻转冷却机制 #

如果使用计时器，确保冷却逻辑正确生效：

private float flipCooldown = 0.5f;
private float lastFlipTime;

private void FixedUpdate()
{
    if (touchingDirections.IsGrounded && touchingDirections.IsOnWall)
    {
        if (Time.time - lastFlipTime > flipCooldown)
        {
            FlipDirection();
            lastFlipTime = Time.time;
        }
    }
}

4. 调整胶囊碰撞体参数 #

缩小胶囊碰撞体的宽度，或调整胶囊垂直偏移量，让底部弧形部分尽可能少覆盖地面两侧，减少触地时左右Cast的误判概率。

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