游戏客户端架构 / 系统课时
事件系统怎么写可重复测试
事件系统怎么写可重复测试
事件总线最难排查的问题往往发生在多个监听器协作时:执行顺序改变、取消订阅后仍被调用,或者一个处理器抛异常导致其他处理器失效。本课使用假事件、同步测试总线和固定断言,验证发布、订阅、取消及异常隔离,让同一测试可以稳定重复执行。
学习目标
- 为事件发布顺序、取消订阅和异常处理定义可测试的行为契约。
- 使用 C# 构建不依赖游戏场景和真实时间的测试程序。
- 通过明确断言定位行为变化,避免依赖日志或随机等待判断测试结果。
先把事件分发契约写清楚
可重复测试的前提是被测试系统存在明确规则。不同事件总线对订阅顺序、分发中的取消操作和异常传播可能有不同约定,不应把其中一种行为误认为所有实现都必须遵守。
本例采用以下约定:
- 发布是同步操作,订阅者按照注册顺序执行。
- 每次发布开始时复制订阅者列表,形成当前分发快照。
- 分发中取消某个订阅,仅影响后续发布,不影响已经生成的当前快照。
- 单个处理器抛出异常时记录异常,并继续执行后续处理器。
- 取消令牌可重复释放,不应因此再次影响事件列表。
使用固定的 FakeEvent 代替真实网络事件,不依赖 Unity 场景、物理帧率或异步定时器。这样测试失败时,原因更可能来自事件系统本身,而不是外部执行环境。
用假事件运行一组断言
下面的程序使用 .NET 8,不依赖第三方测试框架。先执行 dotnet new console -n EventBusTests -f net8.0 创建项目,将代码替换到 Program.cs,再进入项目目录执行 dotnet run。
using System;
using System.Collections.Generic;
using System.Linq;
var bus = new TestBus();
var calls = new List<string>();
IDisposable? cancelB = null;
// A 在收到事件时取消 B,验证当前分发快照的行为。
using var cancelA = bus.Subscribe(e =>
{
calls.Add($"A{e.Id}");
cancelB?.Dispose();
});
cancelB = bus.Subscribe(e => calls.Add($"B{e.Id}"));
using var cancelFault = bus.Subscribe(
_ => throw new InvalidOperationException("boom"));
using var cancelC = bus.Subscribe(e => calls.Add($"C{e.Id}"));
bus.Publish(new FakeEvent(1));
Check(calls.SequenceEqual(new[] { "A1", "B1", "C1" }),
"first publish order");
bus.Publish(new FakeEvent(2));
Check(calls.SequenceEqual(new[] { "A1", "B1", "C1", "A2", "C2" }),
"unsubscribe on next publish");
Check(bus.Errors.Count == 2 &&
bus.Errors.All(e => e is InvalidOperationException),
"error isolation");
static void Check(bool ok, string label)
{
if (!ok) throw new Exception($"FAIL {label}");
Console.WriteLine($"PASS {label}");
}
public sealed record FakeEvent(int Id);
public sealed class TestBus
{
private readonly List<Action<FakeEvent>> handlers = new();
public List<Exception> Errors { get; } = new();
public IDisposable Subscribe(Action<FakeEvent> handler)
{
handlers.Add(handler);
return new Token(() => { handlers.Remove(handler); });
}
public void Publish(FakeEvent e)
{
// 快照固定当次分发顺序,异常不会中断后续监听器。
foreach (var handler in handlers.ToArray())
{
try { handler(e); }
catch (Exception ex) { Errors.Add(ex); }
}
}
private sealed class Token : IDisposable
{
private Action? cancel;
public Token(Action cancel) => this.cancel = cancel;
public void Dispose()
{
// 清空回调使重复取消不会重复修改订阅表。
var action = cancel;
cancel = null;
action?.Invoke();
}
}
}预期输出:
PASS first publish order
PASS unsubscribe on next publish
PASS error isolation程序没有使用随机数、真实网络和等待时间。每次运行都应该得到相同的三行结果。任意断言失败都会抛出异常,并使程序以失败状态结束,而不是把错误隐藏在普通日志中。
取消订阅和异常为什么不会破坏顺序

第一次发布时,事件总线先生成包含 A、B、异常处理器和 C 的订阅快照。A 虽然调用了 B 的取消令牌,但只是从实际订阅列表中移除 B;当前快照仍包含 B,所以 B 会收到事件 1。
异常处理器随后抛出 InvalidOperationException。总线把异常加入 Errors,继续调用 C,因此第一轮执行记录为 A1、B1、C1。
第二次发布重新生成快照,此时 B 已不存在,执行记录只新增 A2、C2。异常处理器仍会抛出异常,因此两轮结束时 Errors.Count 为 2。三个断言分别证明了顺序、取消时机和异常隔离行为。
这里的异常隔离是显式规定的测试契约。生产环境可以采用中断分发策略,但必须同步修改预期行为,并确保关键失败不会被悄悄吞掉。
怎样让正式测试保持确定性
本例的 TestBus 是用于讲解契约的最小实现。真实项目必须将相同断言施加到正式事件总线或其测试适配器上,不能只测试一个独立的假总线,否则无法发现生产代码中的缺陷。
设计自动化测试时,应遵守以下边界:
- 每个测试创建独立总线实例和事件记录列表,避免上一个测试留下的订阅影响结果。
- 用事件唯一 ID 和确定的订阅顺序作为输入,直接比较完整回调序列,不依靠控制台日志肉眼判断。
- 对异步或跨线程总线使用可手动推进的队列执行器或假时钟,明确控制消息何时被处理,不使用任意时长的
Sleep猜测完成时机。 - 分别验证异常传播或隔离策略,并检查失败信息确实被记录;需要并发安全时,再增加并发订阅、取消和发布的专门测试。
同步测试总线适合固定基础行为,真实线程调度和引擎生命周期则需要额外的集成测试。只要输入事件、分发契约和执行时机均可控制,事件系统的回归测试就能从偶发失败转变为稳定、可定位的断言失败。