Unity实现球进洞碰撞触发修改TMPro文本失效报空引用的问题

空引用报错根源 #

• 当前Hole.cs中通过GetComponent<TextMeshProUGUI>()直接在挂载脚本的洞体对象上查找TMPro组件，但实际TMPro文本是独立的UI对象，和洞体不在同一游戏物体上，导致组件获取结果为null。进入碰撞回调时对null对象的text属性赋值，就会触发「对象引用未设置为对象实例」的报错。
• 脚本中定义的[SerializeField] private Collision collision字段完全冗余，OnCollisionEnter传入的碰撞参数可直接在方法内使用，该字段可直接删除，避免误操作在Inspector拖入无效引用引发额外问题。

碰撞回调无响应的必要检查项 #

• Unity物理规则要求：发生碰撞的两个物体必须都挂载Collider组件，且至少其中一个物体挂载非运动学属性的Rigidbody组件，仅靠Collider不会触发任何OnCollisionEnter回调。若开发2D项目，需对应使用Collider2D、Rigidbody2D组件，回调函数替换为2D版本的OnCollisionEnter2D逻辑。
• 检查两个物体的Collider组件，若勾选了Is Trigger属性，实体碰撞的OnCollisionEnter将不会触发，需根据交互需求替换为OnTriggerEnter回调，或取消勾选Trigger选项。
• 检查项目物理碰撞矩阵的层级配置，确认小球和洞体所在的层级没有被设置为互相忽略碰撞。

修正后的可运行代码 #

Hole.cs 修正版本 #

直接通过序列化字段绑定TMPro对象，从根源上避免组件查找错位的问题，增加判空逻辑减少报错概率：

using UnityEngine;
using TMPro;

public class Hole : MonoBehaviour
{
    // 在Inspector面板将场景内的TMPro文本对象拖拽到该字段槽位
    [SerializeField] private TextMeshProUGUI targetText;

    private void OnCollisionEnter(Collision collision)
    {
        // 判空保护，避免未绑定引用直接报错
        if (targetText == null) return;
        
        targetText.text = "Hole hit!";
        // 可选逻辑：仅当碰撞对象标记为Ball标签时才触发反馈
        if (collision.gameObject.CompareTag("Ball"))
        {
            Debug.Log("成功检测到小球碰撞洞体");
        }
    }
}

BallMover.cs 修正版本 #

原代码的移动向量默认在XY平面构建，3D场景下会导致小球沿Y轴（上下方向）异常偏移，调整为3D场景下常规的XZ平面移动逻辑：

using UnityEngine;

public class BallMover : MonoBehaviour
{
    void Update()
    {
        float horizontal = Input.GetAxis("Horizontal");
        float vertical = Input.GetAxis("Vertical");
        // 3D场景下移动沿X/Z轴，Y轴保持初始值
        Vector3 movement = new Vector3(horizontal, 0, vertical);
        transform.position += movement * Time.deltaTime;
    }
}

快速验证流程 #

• 将修正后的Hole脚本挂载到洞体对象上，把场景内的TMPro文本对象拖拽到脚本对应的targetText槽位
• 为小球对象挂载Rigidbody组件，取消勾选Is Kinematic，根据场景需求开启Use Gravity属性
• 确认洞体和小球的Collider组件大小匹配物体实际范围，取消Is Trigger勾选（若需要做穿透进洞的触发逻辑，可保持勾选，同时将Hole脚本内的碰撞回调替换为OnTriggerEnter）
• 运行游戏移动小球与洞体碰撞，即可正常更新TMPro文本内容，不会触发空引用报错。

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