游戏客户端架构 / 系统课时

为什么启动顺序会制造空引用

为什么启动顺序会制造空引用

HUD 偶尔显示空生命条,甚至在敌人刚生成时抛出空引用异常,原因可能不是组件缺失,而是消费方比提供方更早启动。本课用 Health 与 HUD 的依赖关系重现两种失败,建立可验证的“先绑定、再就绪、后消费”初始化契约。

学习目标

  • 判断空引用、默认值和状态覆盖分别发生在哪个启动阶段。
  • 用显式依赖绑定与就绪检查替代碰运气的回调顺序。
  • 验证事件订阅、首次快照与停用清理的配合。

为什么对象存在仍可能读不到数据

假设 HudComponent 在初始化时读取 HealthComponent.CurrentHp。宿主已经创建,不代表 HealthComponent 已附加;即使引用已绑定,也不代表初始生命值已经从配置或存档加载。

现象 直接原因 需要检查
空引用异常 HUD 访问时依赖尚未绑定 附加、注入发生的时间
显示 0 而非 100 Health 已存在但尚未初始化 IsReady 与初始值写入
生命值突然恢复满值 延迟初始化覆盖运行中的状态 是否重复初始化或存在多个写入者

即使所有脚本都在同一线程上运行,也可能因为回调次序不同触发这些问题;异步加载、网络生成和对象池复用只会放大它们。根因是把“拥有引用”误当成“数据已经就绪”。

对照错误时序与正确时序

错误链路是 HUD 先开始读值,随后才建立 Health 引用或初始化生命值。正确链路则先创建并附加组件,再绑定依赖,等 Health 完成初始化后才让 HUD 订阅事件和读取首次快照。

HUD 与生命值组件错误启动顺序及修复时序

用代码复现并阻止过早读取

在 .NET 8 控制台项目的 Program.cs 中运行下面的独立示例。TryStart 只用于展示错误并保留进程,实际项目应让初始化失败显式上报,而不是吞掉异常继续运行。

csharp
using System;

var health = new HealthComponent();
var hud = new HudComponent();

TryStart(hud); // 引用尚未绑定
hud.Bind(health);
TryStart(hud); // 已绑定,但 Health 尚未就绪

health.Initialize(100);
hud.Initialize();
health.TakeDamage(20);
hud.Stop();

static void TryStart(HudComponent target)
{
    try { target.Initialize(); }
    catch (InvalidOperationException error)
    {
        Console.WriteLine($"启动失败:{error.Message}");
    }
}

sealed class HealthComponent
{
    public int CurrentHp { get; private set; }
    public bool IsReady { get; private set; }
    public event Action<int>? HpChanged;

    public void Initialize(int initialHp)
    {
        if (IsReady) throw new InvalidOperationException("Health 不可重复初始化");
        if (initialHp <= 0) throw new ArgumentOutOfRangeException(nameof(initialHp));
        CurrentHp = initialHp;
        IsReady = true;
        Console.WriteLine($"Health 就绪:{CurrentHp}");
    }

    public void TakeDamage(int amount)
    {
        if (!IsReady || amount < 0)
            throw new InvalidOperationException("未就绪或伤害值无效");
        CurrentHp = Math.Max(0, CurrentHp - amount);
        HpChanged?.Invoke(CurrentHp);
    }
}

sealed class HudComponent
{
    private HealthComponent? _health;
    private bool _started;

    public void Bind(HealthComponent health)
    {
        if (_started) throw new InvalidOperationException("运行时不能替换依赖");
        _health = health;
    }

    public void Initialize()
    {
        if (_started) return; // 避免重复订阅
        if (_health is null) throw new InvalidOperationException("Health 未绑定");
        if (!_health.IsReady) throw new InvalidOperationException("Health 尚未初始化");
        _health.HpChanged += ShowHp;
        _started = true;
        ShowHp(_health.CurrentHp); // 订阅后读取首次快照
    }

    public void Stop()
    {
        if (!_started || _health is null) return;
        _health.HpChanged -= ShowHp;
        _started = false;
        Console.WriteLine("HUD 已解绑");
    }

    private static void ShowHp(int hp) => Console.WriteLine($"HUD HP={hp}");
}

预期输出:

text
启动失败:Health 未绑定
启动失败:Health 尚未初始化
Health 就绪:100
HUD HP=100
HUD HP=80
HUD 已解绑

前两次失败分别发生在依赖绑定前和数据就绪前。成功路径中,HUD 订阅变化事件之后立即读取当前值,因此即使初始化时尚无变化事件,也能显示 100;随后 TakeDamage(20) 只通过 Health 修改权威状态,HUD 收到 80 的通知。这个示例按单线程事件分发设计;并发场景还需用受控的快照与订阅握手消除竞态。

用明确契约代替执行顺序补丁

工程中可由对象装配器或启动协调器负责依赖顺序:

  1. 创建宿主并附加全部必需组件;缺失依赖立即报错。
  2. 显式绑定组件引用,不让消费方在构造函数里查找兄弟组件。
  3. 先初始化数据提供者,再初始化依赖它的消费方;若存在循环依赖,拆开“绑定引用”和“读取就绪数据”两个阶段。
  4. 消费方在就绪后订阅事件并同步首次快照,停用或销毁时解除订阅。

验证时分别交换组件创建顺序、延迟 Health 的初始化、停用后重新启用 HUD,并确认不再出现空引用、首次值错误或重复事件。临时调整引擎脚本执行顺序只能掩盖局部问题;当对象来自异步加载或运行中动态生成时,明确的就绪契约才是真正可靠的边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

为什么启动顺序会制造空引用

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

登录哪都通