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

避免事件订阅造成隐性生命周期

避免事件订阅造成隐性生命周期

同一次扣血让 HUD 刷新多次,或关闭界面后仍出现回调报错,常见根因不是发布事件有误,而是长期存活的消息总线仍保存着旧监听函数。本篇把订阅看作必须释放的资源,通过启用、停用和销毁的完整演练,确保对象退出后不再接收消息。

学习目标

  • 识别重复订阅、忘记解绑与回调保留对象引用的因果关系。
  • 用幂等的订阅和取消订阅处理界面启停及销毁。
  • 通过回调次数与监听者数量验证清理确实生效。

为什么销毁对象不等于取消订阅

多数事件总线在内部保存回调集合。回调可能闭包引用 HUD、角色组件或场景节点,因此“界面已从屏幕移除”不代表这些引用已释放;在某些引擎中,底层对象已经销毁,回调却仍会尝试访问其包装对象,产生失效引用错误。

另一类问题发生在反复打开页面:每次启用都注册新回调,却只在最终销毁时解绑,结果一次事件执行多次刷新甚至重复播放音效。判断依据不应只是视觉上有没有界面,而是这个订阅应在哪个阶段生效。

HUD 启停与销毁时错误订阅和正确解绑的时间线对比

把订阅当作需要归还的资源

约定一个清晰的所有权规则:谁注册,谁保存取消函数并负责释放。只在活跃时需要消息的 HUD 应在启用时订阅、停用时解绑,并在销毁时再次做幂等清理;如果后台系统必须持续监听,则改由与其相同生命周期的系统对象持有订阅。

还需要守住三个边界:启用两次不能创建两个活跃订阅;取消订阅可以重复调用而不报错;一旦销毁,不允许再次启用。事件总线还应允许在发布回调期间安全解绑。这样“谁还在监听”才能被测试,而不只是靠人工猜测。

完整示例:反复启用也只订阅一次

把代码保存为 subscription-lifecycle.js,用 Node.js 18 或更新版本执行。示例里的 HUD 在回调中更新自身状态,因此只要总线保留回调,就可能间接保留 HUD 实例。

js
class EventBus {
  constructor() {
    this.listeners = new Map();
  }

  subscribe(type, handler) {
    const set = this.listeners.get(type) ?? new Set();
    set.add(handler);
    this.listeners.set(type, set);
    let active = true;
    // 返回幂等取消函数,订阅者不必操作总线内部集合。
    return () => {
      if (!active) return;
      active = false;
      set.delete(handler);
      if (set.size === 0) this.listeners.delete(type);
    };
  }

  publish(type, payload) {
    for (const handler of [...(this.listeners.get(type) ?? [])]) {
      handler(payload);
    }
  }

  listenerCount(type) {
    return this.listeners.get(type)?.size ?? 0;
  }
}

class HealthHud {
  constructor(bus) {
    this.bus = bus;
    this.unsubscribe = null;
    this.destroyed = false;
    this.hp = null;
    // 回调引用 this,若不解绑可能让 HUD 被长期保留。
    this.onHealthChanged = ({ hp }) => {
      this.hp = hp;
      console.log(`HUD 显示 HP=${this.hp}`);
    };
  }

  enable() {
    if (this.destroyed) throw new Error("已销毁的 HUD 不能启用");
    if (this.unsubscribe) return; // 防止重复启用造成重复订阅。
    this.unsubscribe = this.bus.subscribe(
      "player.health.changed", this.onHealthChanged
    );
  }

  disable() {
    this.unsubscribe?.();
    this.unsubscribe = null;
  }

  destroy() {
    this.disable(); // 即使调用方忘记停用,销毁仍能释放订阅。
    this.destroyed = true;
  }
}

const bus = new EventBus();
const hud = new HealthHud(bus);
hud.enable();
hud.enable();
bus.publish("player.health.changed", { hp: 80 });
console.log(`活跃订阅:${bus.listenerCount("player.health.changed")}`);

hud.disable();
bus.publish("player.health.changed", { hp: 60 });
hud.enable();
bus.publish("player.health.changed", { hp: 50 });
hud.destroy();
bus.publish("player.health.changed", { hp: 0 });
console.log(`销毁后订阅:${bus.listenerCount("player.health.changed")}`);

预期输出:

text
HUD 显示 HP=80
活跃订阅:1
HUD 显示 HP=50
销毁后订阅:0

停用期间的 hp: 60 和销毁后的 hp: 0 均没有触发 HUD。再次启用后收到 hp: 50,说明它重新订阅了一次,而不是叠加旧监听。这里的 listenerCount 只是测试辅助接口,不应把监听数量当成业务状态。

验收与容易遗漏的边界

回归时至少执行“启用两次→停用→再次启用→销毁→再次发布”,逐段核对监听数量分别为 1、0、1、0。若一个对象订阅了多种事件,应把所有取消函数集中保管并在同一生命周期出口释放,而不是漏掉某一个主题。

事件也不是状态仓库:HUD 停用期间错过的血量变化不会被总线自动补发。重新启用时应先从角色的权威状态读取当前 HP,再接收增量事件。只有订阅与状态恢复都处理完整,界面生命周期才真正可控。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免事件订阅造成隐性生命周期

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

登录哪都通