游戏客户端架构 / 系统课时
全局总线为什么容易变成垃圾桶
全局总线为什么容易变成垃圾桶
当战斗、背包、界面和存档都向同一个静态事件总线发送消息时,模块看似不再互相引用,却可能共享大量难以追踪的隐式依赖。本篇通过游戏生命值通知的案例,划清直接调用、局部事件域和应用级消息的边界,并实现一套具有明确生命周期的事件通信方案。
学习目标
- 识别全局单例事件总线被滥用时产生的隐式依赖和生命周期问题。
- 根据消息的作用范围,选择模块接口、局部事件域或应用级事件。
- 使用 C# 实现可注入、可订阅和可清理的局部事件域。
全局总线失控的信号
事件总线的原始价值,是让消息发布者不必知道所有订阅者。例如角色受到伤害后,生命值系统可以发布 HealthChanged,由 HUD、音效和战斗日志分别处理。
问题出现在所有模块都开始依赖同一个 GlobalEventBus.Instance。背包操作、UI 按钮点击、任务判断、网络状态和场景切换都通过全局广播完成,事件总线便逐渐成为任何模块都能读写的公共通信空间。
这种设计通常出现以下信号:
- 事件含义模糊:多个模块共用
DataChanged、Refresh等宽泛事件,订阅者必须通过额外字段猜测发生了什么。 - 依赖难以发现:修改一次事件载荷,可能影响多个场景中互不相关的订阅者,编译器也无法发现全部行为依赖。
- 生命周期混乱:短生命周期的界面订阅长期存在的总线,界面关闭后仍可能被回调。
- 执行顺序被误用:某个系统依赖另一个订阅者先完成状态修改,却没有显式调用关系和顺序契约。
- 测试难以隔离:测试必须清理全局订阅者和共享状态,否则前一个测试可能改变后一个测试的结果。
从消息的受众决定事件域
设计通信方式时,先判断消息由谁产生、谁需要处理,以及这些对象是否具有相同的生命周期。不要先建立一个全局总线,再让所有系统向它注册。

可以把通信需求分成三类:
| 通信需求 | 推荐方式 | 判断依据 |
|---|---|---|
| 需要立即执行操作并获得结果 | 模块接口 | 调用者需要返回值、错误信息或明确的执行结果 |
| 同一场景内多个模块响应状态变化 | 局部事件域 | 发布者和订阅者属于同一业务场景或功能作用域 |
| 多个场景都需要感知应用级状态变化 | 应用级事件 | 消息的意义和生命周期确实超越单个场景 |
例如,角色使用道具需要确认物品是否存在、数量是否足够,以及是否成功扣除库存。这是需要明确结果的操作,应调用背包服务接口,而不是发布 UseItemRequested 后假设某个订阅者会完成处理。
角色生命值已经改变,则属于既成事实,适合向当前战斗场景发布 HealthChanged。如果游戏语言发生改变,跨场景常驻的设置界面也需要更新,可以使用应用级 LocaleChanged 通知。
核心原则是让事件域的生命周期不超过它实际需要服务的业务范围。同一事件名称在两个相互隔离的场景中使用,并不意味着它们必须共享订阅者。
用实例事件域代替万能单例
下面使用 C# 实现两个独立事件域:BattleEvents 服务当前战斗,AppEvents 服务应用级语言设置。战斗 HUD 通过构造函数获得局部事件域实例,并在释放时解除订阅。
准备安装 .NET 8 或更新版本的 SDK,在终端执行 dotnet new console -n EventScopeDemo 创建控制台项目,将 Program.cs 替换为以下完整代码。
using System;
var appEvents = new AppEvents();
var battleEvents = new BattleEvents();
using var hud = new BattleHud(battleEvents);
var health = new HealthSystem(battleEvents);
appEvents.LocaleChanged += locale =>
Console.WriteLine($"App locale: {locale}");
health.TakeDamage(25);
appEvents.ChangeLocale("zh-CN");
public sealed class BattleEvents
{
public event Action<int>? HealthChanged;
// 战斗事件只发布当前战斗的生命值变化。
public void RaiseHealthChanged(int hp) =>
HealthChanged?.Invoke(hp);
}
public sealed class AppEvents
{
public event Action<string>? LocaleChanged;
public void ChangeLocale(string locale) =>
LocaleChanged?.Invoke(locale);
}
public sealed class HealthSystem
{
private readonly BattleEvents _events;
private int _hp = 100;
public HealthSystem(BattleEvents events) => _events = events;
public void TakeDamage(int amount)
{
if (amount < 0)
throw new ArgumentOutOfRangeException(nameof(amount));
// 业务状态先更新,再发布已经发生的事实。
_hp = Math.Max(0, _hp - amount);
_events.RaiseHealthChanged(_hp);
}
}
public sealed class BattleHud : IDisposable
{
private readonly BattleEvents _events;
public BattleHud(BattleEvents events)
{
_events = events;
_events.HealthChanged += OnHealthChanged;
}
private static void OnHealthChanged(int hp) =>
Console.WriteLine($"HUD HP: {hp}");
// 作用域结束时移除订阅,避免回调继续引用旧对象。
public void Dispose() =>
_events.HealthChanged -= OnHealthChanged;
}进入 EventScopeDemo 项目目录执行 dotnet run。
预期输出:
HUD HP: 75
App locale: zh-CN第一行来自战斗事件域,第二行来自应用事件域。两者没有共享事件列表,HealthSystem 也不需要引用 HUD。
实际项目中,可以在创建战斗场景或业务会话时构造 BattleEvents,将同一个实例注入场景内的发布者和订阅者。场景结束后,先让订阅者执行清理,再释放整个局部事件域。示例中的 using var hud 就展示了这一清理责任。
需要注意,AppEvents 在这里同样是显式创建的实例,不必写成静态单例。应用根对象或依赖注入容器可以管理它的生命周期,从而让测试使用独立实例。
为全局事件建立准入条件
全局事件不是绝对不能使用,而是需要比局部事件更严格的约束。决定将一个事件提升到应用级之前,检查三个问题:
- 是否真的跨作用域:至少存在明确的跨场景或常驻系统订阅需求,而不只是当前实现方便。
- 是否表达已经发生的事实:例如语言设置已改变、玩家身份已切换,而不是要求某个未知订阅者执行关键操作。
- 谁负责维护契约与清理订阅:事件名称、载荷类型、发布时机和订阅对象的生命周期都必须有明确归属。
应用级事件应使用稳定、具体的名称,例如 LocaleChanged,避免把 ObjectChanged 作为所有模块通用的消息。重要的业务结果不应依赖无人检查的事件处理器完成。
还要区分事件通知与状态查询。事件告诉订阅者发生了什么,但新进入场景的订阅者可能已经错过事件。需要取得当前语言或当前玩家资料时,应向对应服务查询现有状态,而不是期待全局总线重新广播历史消息。
在工程实践中,优先选择明确的模块接口,其次使用场景或功能级事件域,只有经过跨场景需求验证的通知才进入应用级事件域。这样才能让事件系统保持解耦能力,而不是成为隐藏所有依赖的公共垃圾桶。