游戏客户端架构 / 系统课时
订阅对象销毁后谁来清理
订阅对象销毁后谁来清理
当玩家界面、敌人或临时特效被销毁时,事件总线可能仍保存它们的回调,导致无效通知和对象无法释放。本课通过可注销的订阅令牌管理回调,并比较手动注销、生命周期绑定和弱引用三种方案,确定不同游戏对象适合的清理策略。
学习目标
- 解释事件订阅为什么可能阻止对象释放,以及销毁后回调的风险。
- 比较三种清理策略,并根据对象生命周期选择方案。
- 实现可重复注销的订阅令牌,验证销毁后不再收到事件。
为什么销毁对象不等于取消订阅
假设全局事件总线保存了 HUD 的生命值变化回调。HUD 被关闭后,如果没有取消订阅,总线中的委托仍可能引用 HUD 实例。在 C# 中,这种强引用会阻止对象被垃圾回收;在 Unity 中,即使对应的游戏对象已经销毁,托管委托也可能继续被调用。
问题的根源是两个生命周期没有自动绑定:游戏对象负责自身的启用和销毁,事件总线负责保存和调用订阅者。对象离开场景,并不意味着总线知道它已经失效。

由此可能出现三种故障:已关闭界面仍刷新、已销毁对象的回调访问无效组件,以及长期游玩过程中订阅数量持续增长。清理责任必须在订阅建立时明确,而不能寄希望于垃圾回收。
三种清理方案怎样选择
| 方案 | 工作方式 | 适用场景与限制 |
|---|---|---|
| 手动注销 | 保存原始回调,在退出时调用注销接口 | 依赖关系简单;容易遗漏或重复注册 |
| 生命周期绑定 | 订阅时获取令牌,由对象生命周期统一释放 | HUD、敌人、场景组件;推荐作为默认方案 |
| 弱引用订阅 | 总线不强持有订阅目标,派发时跳过并清理失效引用 | 观察型通知;清理时机不确定,实现复杂 |
手动注销可以使用 C# 的 event 与 -=,但必须传入与注册时相同的委托。分别创建的匿名 Lambda 即使代码相似,也通常不是同一个委托实例,因此不应依赖重新书写 Lambda 来退订。
生命周期绑定更适合游戏客户端。Unity 组件只应在启用期间接收事件时,可以在 OnEnable 注册、OnDisable 注销;若禁用期间仍需接收事件,则应明确选择其他注册和清理时机,例如初始化与 OnDestroy。两种策略不能随意混用,否则容易重复订阅。
弱引用不是万能的自动退订机制。它不会阻止目标被回收,但需要处理目标已消失、失效条目清理以及回调中其他强引用的问题。对于必须确定何时停止接收通知的游戏对象,不应将弱引用作为唯一保障。
用订阅令牌实现确定性清理
下面使用 .NET 8 控制台项目演示。DamageBus 保存伤害事件订阅者,Subscribe 返回实现 IDisposable 的令牌。HUD 保存令牌,并在自身释放时调用 Dispose。将完整代码放入 Program.cs,使用 dotnet run 执行。
using System;
using System.Collections.Generic;
public sealed class DamageBus
{
private readonly List<Action<int>> _listeners = new();
public IDisposable Subscribe(Action<int> listener)
{
_listeners.Add(listener);
return new Subscription(() => _listeners.Remove(listener));
}
public void Publish(int amount)
{
// 使用快照,避免回调注销时修改正在遍历的集合。
foreach (var listener in _listeners.ToArray())
listener(amount);
}
private sealed class Subscription : IDisposable
{
private Action? _detach;
public Subscription(Action detach) => _detach = detach;
public void Dispose()
{
// 清空注销动作,让重复释放不会重复操作。
var detach = _detach;
_detach = null;
detach?.Invoke();
}
}
}
public sealed class Hud : IDisposable
{
private readonly IDisposable _token;
public Hud(DamageBus bus)
{
_token = bus.Subscribe(amount =>
Console.WriteLine($"HUD damage: {amount}"));
}
public void Dispose() => _token.Dispose();
}
public static class Program
{
public static void Main()
{
var bus = new DamageBus();
using (var hud = new Hud(bus))
bus.Publish(10);
// HUD 订阅已注销,第二次发布不会调用它。
bus.Publish(5);
Console.WriteLine("After dispose: no HUD callback");
}
}预期输出:
HUD damage: 10
After dispose: no HUD callback第一次发布触发 HUD 输出。离开 using 作用域时,HUD 的 Dispose 调用订阅令牌,令牌从总线中移除委托。第二次发布不会触发 HUD,因此只看到最后一行验证消息。
实际 Unity 项目中,可以让组件字段保存该令牌,再从约定的生命周期方法调用 Dispose。总线不必知道 HUD 的类型,也不需要主动追踪游戏对象是否已经销毁。
注销时序与边界条件
令牌解决了明确注销的问题,但仍须规定派发期间的行为。本例遍历订阅快照,因此某个回调即使在本轮派发中注销了另一个订阅者,后者仍可能被当前快照调用一次。注销保证后续派发不再包含该订阅者,不代表能撤销已经开始的派发。
工程中应检查以下条件:
- 重复调用
Dispose不抛异常,也不会重复注销。 - 对象反复启用和禁用时,活动订阅数量不会持续增加。
- 组件退出场景后发布同类事件,不再触发它的回调。
- 事件处理中触发对象销毁时,回调访问状态有明确保护。
如果采用线程并发派发,还需要同步订阅表并定义注销与回调执行的并发关系;当前示例仅面向游戏主线程。对于多数主线程客户端事件系统,生命周期绑定加可重复释放的订阅令牌,是最容易验证、也最便于维护的默认选择。