Unity中Raycast2D.collider非空但Debug.DrawRay显示异常问题

我写了一个敌人左右移动的脚本，逻辑是敌人靠近墙壁时转向，但遇到了诡异的问题：Raycast2D.collider返回不为空，但Debug.DrawRay显示的射线明明没碰到任何物体。已经尝试过将射线起始位置移离敌人，也确认所有墙壁都带有Box Collider2D，场景里没有多余碰撞体，但问题依然存在。

Update中处理射线检测的代码片段如下：

timer += Time.deltaTime;
Debug.Log("Right is " + right);
Debug.Log("Left is " + left);
if (timer > 1f)
{
    raycastHitLeft = Physics2D.Raycast(new Vector2(transform.position.x - 1, transform.position.y), new Vector2(-2, 0));
    Debug.DrawRay(new Vector3(transform.position.x - 1, transform.position.y, transform.position.z), new Vector3 (-2, 0, 0), Color.red, 1f);
    raycastHitRight = Physics2D.Raycast(new Vector2(transform.position.x + 1, transform.position.y), new Vector2(2, 0));
    Debug.DrawRay(new Vector3(transform.position.x + 1, transform.position.y, transform.position.z), new Vector3(2, 0, 0), Color.blue, 1f);
    timer = 0;

    Debug.Log("Raycast fired!");
}

问题根源与解决方法 #

1. 射线检测参数与Debug显示的核心差异

Physics2D.Raycast的第二个参数是方向向量，而非终点偏移，且默认射线长度为无限远。你代码里写的new Vector2(-2, 0)只是指定了向左的方向，实际检测的射线会从起点一直向左延伸；而Debug.DrawRay的第二个参数是位移向量，只画出了2单位长度的射线。这就导致：当碰撞体在2单位之外时，Debug视图里看不到射线碰到物体，但Raycast已经检测到了，自然会返回非空的collider。

修正方式：给Physics2D.Raycast添加明确的distance参数，让实际检测长度和Debug显示的射线长度一致：

float rayLength = 2f;
// 左侧射线：方向向左，长度2
raycastHitLeft = Physics2D.Raycast(new Vector2(transform.position.x - 1, transform.position.y), Vector2.left, rayLength);
Debug.DrawRay(new Vector3(transform.position.x - 1, transform.position.y, transform.position.z), Vector2.left * rayLength, Color.red, 1f);

2. 未过滤图层导致误检测自身或其他物体

即使你把射线起始位置移开了敌人，仍有可能检测到敌人自身的碰撞体（比如敌人的Collider范围较大），或者场景中其他未注意到的碰撞体。

修正方式：创建一个专门的Wall图层，给所有墙壁设置该图层，然后在Raycast中添加图层过滤：

// 获取墙壁图层的掩码
int wallLayerMask = LayerMask.GetMask("Wall");
// 只检测墙壁图层的碰撞体
raycastHitLeft = Physics2D.Raycast(new Vector2(transform.position.x - 1, transform.position.y), Vector2.left, rayLength, wallLayerMask);

3. 检查碰撞体的IsTrigger属性

如果墙壁的BoxCollider2D勾选了IsTrigger，Physics2D.Raycast默认不会检测到这类碰撞体。需要显式设置检测触发器：

raycastHitLeft = Physics2D.Raycast(
    new Vector2(transform.position.x - 1, transform.position.y), 
    Vector2.left, 
    rayLength, 
    wallLayerMask,
    QueryTriggerInteraction.Collide // 允许检测触发器
);

4. 打印碰撞体信息排查

在Raycast后添加日志，输出检测到的碰撞体名称，能直接确认到底是哪个物体被检测到了：

Debug.Log("左侧射线碰撞体：" + (raycastHitLeft.collider ? raycastHitLeft.collider.name : "无"));
Debug.Log("右侧射线碰撞体：" + (raycastHitRight.collider ? raycastHitRight.collider.name : "无"));

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