游戏引擎 / 系统课时

定位生命周期导致的空引用

定位生命周期导致的空引用

Unity 场景切换后,HUD 可能在 OnEnable 中读取尚未初始化的服务,或仍保存着已销毁的旧场景对象。本课把异常堆栈与 Awake、OnEnable、Start 的时序对齐,找出引用失效的位置,并用日志复现和验证修复。

学习目标

  • 从异常堆栈确认未赋值、初始化过早或对象已销毁的具体引用。
  • 理解单对象与跨对象回调顺序,以及场景载入的边界。
  • 编写生命周期探针,验证重绑和取消订阅是否生效。

从异常行确认空的是哪个引用

先在 Console 中关闭 Collapse,选中第一条 NullReferenceException,展开堆栈并跳到最上方属于项目脚本的调用行。若出错表达式类似 GameSession.Instance.Player.Health,必须分别检查 Instance 与 Player,不能只给整行加一次空判断。

如果引用类型是 UnityEngine.Object,还要考虑对象已被 Destroy:托管字段可能仍保存包装对象,但 Unity 的 == null 检查会把它判为空。场景卸载后,持久化管理器继续指向旧 HUD、旧 Player,是常见原因。MissingReferenceException 往往更直接提示这类已销毁对象问题。

排查时记录对象名、场景名、调用阶段和引用是否有效。只在报错处 return 能止住异常,却可能让血条不再刷新;应继续追踪是谁负责创建、注入和替换该依赖。

把生命周期放在同一条时间线上

对同一个已激活对象,Awake 先于 OnEnable,Start 在首次 Update 前执行且只调用一次;禁用再启用会再次触发 OnEnable,不会重跑 Start。同一场景中预先存在的活动对象通常会先完成各自的 Awake、OnEnable,然后才进入 Start 阶段。

但不同对象的 Awake 与 OnEnable 没有可靠的相互先后关系。例如 HUD 的 OnEnable 可能先于 GameRoot 的 Awake,此时读取静态 Instance 就会失败;运行时动态实例化和起初未激活的对象,还不能套用“所有对象已初始化”的假设。通过 SceneManager 载入场景时,sceneLoaded 通知发生在该场景对象 OnEnable 之后、Start 之前。

跨对象初始化顺序、场景切换与空引用风险的时序图

用探针定位第一个异常阶段

将下列代码保存为 LifecycleProbe.cs,挂在出问题的对象上,在 Inspector 中把待检查的对象拖入 Dependency。先检查初次进入场景,再测试禁用启用与场景切换;若探针挂在跨场景保留的管理器上,还能检查它对旧场景对象的引用是否失效。

csharp
using UnityEngine;
using UnityEngine.SceneManagement;

public sealed class LifecycleProbe : MonoBehaviour
{
    [SerializeField] private GameObject dependency;

    private void Awake() => Trace("Awake");

    private void OnEnable()
    {
        // 订阅和取消订阅必须配对。
        SceneManager.sceneLoaded += OnSceneLoaded;
        Trace("OnEnable");
    }

    private void Start() => Trace("Start");

    private void OnSceneLoaded(Scene scene, LoadSceneMode mode)
    {
        Trace($"sceneLoaded:{scene.name}");
    }

    private void OnDisable()
    {
        SceneManager.sceneLoaded -= OnSceneLoaded;
        Trace("OnDisable");
    }

    private void OnDestroy() => Trace("OnDestroy");

    private void Trace(string phase)
    {
        // Unity 已销毁对象也会在此判为缺失。
        string state = dependency == null ? "MISSING" : "OK";
        Debug.Log($"[{name}] {phase} dependency={state}", this);
    }
}

预期输出(对象名为 HUD,已正确绑定依赖;下列为关键日志,sceneLoaded 回调可能插在 OnEnable 与 Start 之间):

text
[HUD] Awake dependency=OK
[HUD] OnEnable dependency=OK
[HUD] Start dependency=OK

当 dependency 未配置或指向已销毁对象时,对应日志会显示 MISSING。点击 Console 日志可定位到探针挂载对象,而不是依赖猜测对象何时失效。

按依赖所有权修复问题

同对象组件可在 Awake 通过 GetComponent 获取;跨对象的固定依赖优先用 [SerializeField] 在 Inspector 明确绑定,并在启动时校验。若必须读取其他组件在 Awake 中计算出的状态,初始场景可在 Start 做首次刷新,或由服务主动发出“初始化完成”通知,而不是让 HUD 在 OnEnable 盲读单例。

事件订阅通常由 OnEnable 建立、OnDisable 解除,但前提是依赖已可用;依赖晚到时应等就绪后订阅,并防止重复注册。跨场景常驻服务不应长期缓存旧场景 UI:卸载时解除旧绑定,载入新场景后重新查找或注入新实例。Start 只执行一次,因此不能单靠它处理面板二次启用。Script Execution Order 只能作为受控场景中的最后手段,不能替代明确的依赖契约。

验证首次进入与重复切换

按“启动 → 进入玩法场景 → 返回菜单 → 再进入玩法 → 禁用并重新启用 HUD”的路径检查 Console。确认首次激活时 Awake、Start 各一次,后续激活只增加 OnEnable,关闭时有对应 OnDisable;场景切换后任何被销毁的引用都不再用于业务访问。

最后让一次生命值变化只触发一次 HUD 更新,并在第二次进入场景后重测。如果异常消失但 UI 不刷新,应优先检查是否为了避空而跳过了重绑,而不是继续增加空值保护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位生命周期导致的空引用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通