Unity RaycastHit2D射线检测失效 始终返回true问题排查

检索相关开发资料后仍未定位冲刺技能碰撞检测逻辑的异常：该段逻辑返回布尔值，返回true时允许执行冲刺，返回false时禁止冲刺。当前所有Debug日志输出的位置、方向、距离参数均符合预期，但无论射线是否命中碰撞体，方法始终返回true，导致角色可穿过本应阻挡冲刺的墙体。

相关实现代码如下：

private bool CanMove(GameObject parent, Vector3 dir, float dis)
{
    RaycastHit2D rayCastHit = Physics2D.Raycast(parent.GetComponent<Transform>().position, dir, dis, Enemies);

    Debug.Log(parent.GetComponent<Transform>().position);
    Debug.Log(dir);
    Debug.Log(dis);

    if (rayCastHit.collider == null)
    {
        Debug.Log("true");
        return true;
    }
    else
    {
        Debug.Log("false");
        return false;
    }
}

测试场景记录（角色穿过阻挡墙体后的日志输出）：

核心问题出在射线检测的层掩码配置：你传入的Enemies层掩码只会让射线检测位于Enemies层级的碰撞体，阻挡冲刺的墙体不在该检测层级内，因此射线永远不会命中墙体，rayCastHit.collider始终为null，方法就会永远返回true。

• 调整射线检测的层掩码，将墙体所在的层级加入检测范围。如果需要同时检测敌人和墙体，可通过位运算合并层，示例：LayerMask.GetMask("Enemies", "Wall")，将"Wall"替换为你项目中墙体实际所在的层名即可。
• 额外排查项：
  • 确认墙体对象挂载了2D碰撞体组件（如BoxCollider2D、CompositeCollider2D）
  • 如果墙体碰撞体勾选了Is Trigger属性，默认不会被2D射线检测命中，可根据需求调整Physics2D.queriesHitTriggers全局设置，或在射线检测参数中开启触发器命中
  • 调试时可在射线检测代码后添加Debug.DrawRay(parent.transform.position, dir * dis, Color.red, 1f);，在Scene视图开启Gizmos后即可直观看到射线的实际发射路径、长度和命中对象，快速验证检测范围是否正确。

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