游戏客户端架构 / 系统课时
避免事件订阅造成隐性生命周期
避免事件订阅造成隐性生命周期
同一次扣血让 HUD 刷新多次,或关闭界面后仍出现回调报错,常见根因不是发布事件有误,而是长期存活的消息总线仍保存着旧监听函数。本篇把订阅看作必须释放的资源,通过启用、停用和销毁的完整演练,确保对象退出后不再接收消息。
学习目标
- 识别重复订阅、忘记解绑与回调保留对象引用的因果关系。
- 用幂等的订阅和取消订阅处理界面启停及销毁。
- 通过回调次数与监听者数量验证清理确实生效。
为什么销毁对象不等于取消订阅
多数事件总线在内部保存回调集合。回调可能闭包引用 HUD、角色组件或场景节点,因此“界面已从屏幕移除”不代表这些引用已释放;在某些引擎中,底层对象已经销毁,回调却仍会尝试访问其包装对象,产生失效引用错误。
另一类问题发生在反复打开页面:每次启用都注册新回调,却只在最终销毁时解绑,结果一次事件执行多次刷新甚至重复播放音效。判断依据不应只是视觉上有没有界面,而是这个订阅应在哪个阶段生效。

把订阅当作需要归还的资源
约定一个清晰的所有权规则:谁注册,谁保存取消函数并负责释放。只在活跃时需要消息的 HUD 应在启用时订阅、停用时解绑,并在销毁时再次做幂等清理;如果后台系统必须持续监听,则改由与其相同生命周期的系统对象持有订阅。
还需要守住三个边界:启用两次不能创建两个活跃订阅;取消订阅可以重复调用而不报错;一旦销毁,不允许再次启用。事件总线还应允许在发布回调期间安全解绑。这样“谁还在监听”才能被测试,而不只是靠人工猜测。
完整示例:反复启用也只订阅一次
把代码保存为 subscription-lifecycle.js,用 Node.js 18 或更新版本执行。示例里的 HUD 在回调中更新自身状态,因此只要总线保留回调,就可能间接保留 HUD 实例。
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")}`);预期输出:
HUD 显示 HP=80
活跃订阅:1
HUD 显示 HP=50
销毁后订阅:0停用期间的 hp: 60 和销毁后的 hp: 0 均没有触发 HUD。再次启用后收到 hp: 50,说明它重新订阅了一次,而不是叠加旧监听。这里的 listenerCount 只是测试辅助接口,不应把监听数量当成业务状态。
验收与容易遗漏的边界
回归时至少执行“启用两次→停用→再次启用→销毁→再次发布”,逐段核对监听数量分别为 1、0、1、0。若一个对象订阅了多种事件,应把所有取消函数集中保管并在同一生命周期出口释放,而不是漏掉某一个主题。
事件也不是状态仓库:HUD 停用期间错过的血量变化不会被总线自动补发。重新启用时应先从角色的权威状态读取当前 HP,再接收增量事件。只有订阅与状态恢复都处理完整,界面生命周期才真正可控。