游戏引擎 / 系统课时
定位生命周期导致的空引用
定位生命周期导致的空引用
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。先检查初次进入场景,再测试禁用启用与场景切换;若探针挂在跨场景保留的管理器上,还能检查它对旧场景对象的引用是否失效。
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 之间):
[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 不刷新,应优先检查是否为了避空而跳过了重绑,而不是继续增加空值保护。