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
相关产品推荐
相关产品推荐

