You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Unity3D中Physics.Raycast返回true但RaycastHit.collider为空的问题

Unity射线检测空引用异常(NullReferenceException)修复

核心问题分析

  1. 未实时更新射线检测结果:原代码仅在Start中注释了射线检测逻辑,FixedUpdate里没有执行Physics.Raycast为hit变量赋值,导致hit始终处于未初始化状态,访问hit.collider必然触发空引用异常。
  2. 语法错误:Debug.Log(hit.collider.);语句中hit.collider后多了一个多余的点,会直接导致编译失败。

修正后的完整代码

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class Grapple : MonoBehaviour
{
    public Camera cam;
    public float distance = 5f;
    //public GameObject line;

    void Start()
    {
        // 自动获取主相机,避免因未在Inspector赋值导致的空引用
        if (cam == null)
        {
            cam = Camera.main;
        }
    }

    void FixedUpdate()
    {
        // 创建射线:从相机位置出发,沿相机前方向
        Ray ray = new Ray(cam.transform.position, cam.transform.forward);
        
        // 执行射线检测,将结果存入局部hit变量
        if (Physics.Raycast(ray, out RaycastHit hit, distance))
        {
            // 输出碰撞器所属物体的名称
            Debug.Log("检测到物体:" + hit.collider.name);
            // Scene视图中绘制绿色射线表示检测成功
            Debug.DrawRay(ray.origin, ray.direction * distance, Color.green);
        }
        else
        {
            Debug.Log("5单位范围内无碰撞物体");
            // Scene视图中绘制红色射线表示检测失败
            Debug.DrawRay(ray.origin, ray.direction * distance, Color.red);
        }
    }
}

关键修正说明

  • 移除全局RaycastHit变量,改用局部变量通过out参数接收检测结果,确保每次检测都能获取最新数据。
  • 在FixedUpdate中执行射线检测,保证每帧都能更新检测状态。
  • 修复Debug.Log的语法错误,正确访问hit.collider.name获取物体名称。
  • 添加相机空值判断,自动绑定主相机,降低配置出错概率。
  • 调整Debug.DrawRay逻辑,根据检测结果切换射线颜色,便于调试观察。

内容的提问来源于stack exchange,提问作者SolarIsCool

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.26 04:18:17