You need to enable JavaScript to run this app. Unity 2D开发中Raycast未命中触发空引用错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Unity 2D开发中Raycast未命中触发空引用错误如何解决?

报错根因
  • 核心触发原因:Physics2D.Raycast未命中任何碰撞体时,返回的RaycastHit2D结构体中的transform属性为null,你的代码直接在hitInfo的判断分支外访问hitInfo.transform.name,空引用访问直接触发该报错。
  • 额外可能触发点:你代码中声明的public字段(firepoint、linerend、gun、rbForPlayer)如果未在Unity Inspector面板中赋值,调用其属性/方法时也会触发同类空引用报错。
修复方案

你需要将射线命中后的业务逻辑移入hitInfo有效判断块内,同时增加多层空值校验逻辑,修改后的完整代码如下:

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

public class gun_script : MonoBehaviour
{
    public Transform firepoint;
    public LineRenderer linerend;
    public Transform gun;
    public float mouseSens;
    public int jumpHeight = 5;
    float lookangle;
    public Rigidbody2D rbForPlayer;
    Vector2 lookDirection;
    private bool isJumping = false;

    // Update is called once per frame
    void Update()
    {
        // 前置空校验,避免public字段未赋值报错
        if (firepoint == null || linerend == null || gun == null || rbForPlayer == null || Camera.main == null)
        {
            return;
        }

        isJumping = false;
        lookDirection = Camera.main.WorldToScreenPoint(Input.mousePosition);
        lookangle = Mathf.Atan2(lookDirection.y, lookDirection.x) * Mathf.Rad2Deg;
        gun.rotation = Quaternion.Euler(0, 0, lookangle * mouseSens);

        RaycastHit2D hitInfo = Physics2D.Raycast(firepoint.position, firepoint.right);

        if (hitInfo)
        {
            linerend.SetPosition(0, firepoint.position);
            linerend.SetPosition(1, hitInfo.point);
            // 只有射线命中后才进行碰撞体判断,额外加transform非空校验
            if (hitInfo.transform != null && hitInfo.transform.name == "jumppad" && !isJumping)
            {
                Invoke("Jump", 1f);
            }
        }
        else
        {
            linerend.SetPosition(0, firepoint.position);
            linerend.SetPosition(1, firepoint.position + firepoint.right * 100);
        }
    }

    void Jump()
    {
        isJumping = true;
        rbForPlayer.AddForce(new Vector2(0, jumpHeight));
    }
}
关键修改说明
  • 增加了所有公共引用的前置非空校验,避免Inspector未赋值导致的空引用问题
  • 将碰撞体标签判断逻辑移入if (hitInfo)分支内,保证只有射线命中时才访问hitInfo的相关属性
  • 额外增加hitInfo.transform != null校验,避免极端情况下命中无transform组件的特殊对象导致的报错

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.14 22:57:03