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

事件系统怎么写可重复测试

事件系统怎么写可重复测试

事件总线最难排查的问题往往发生在多个监听器协作时:执行顺序改变、取消订阅后仍被调用,或者一个处理器抛异常导致其他处理器失效。本课使用假事件、同步测试总线和固定断言,验证发布、订阅、取消及异常隔离,让同一测试可以稳定重复执行。

学习目标

  • 为事件发布顺序、取消订阅和异常处理定义可测试的行为契约。
  • 使用 C# 构建不依赖游戏场景和真实时间的测试程序。
  • 通过明确断言定位行为变化,避免依赖日志或随机等待判断测试结果。

先把事件分发契约写清楚

可重复测试的前提是被测试系统存在明确规则。不同事件总线对订阅顺序、分发中的取消操作和异常传播可能有不同约定,不应把其中一种行为误认为所有实现都必须遵守。

本例采用以下约定:

  • 发布是同步操作,订阅者按照注册顺序执行。
  • 每次发布开始时复制订阅者列表,形成当前分发快照。
  • 分发中取消某个订阅,仅影响后续发布,不影响已经生成的当前快照。
  • 单个处理器抛出异常时记录异常,并继续执行后续处理器。
  • 取消令牌可重复释放,不应因此再次影响事件列表。

使用固定的 FakeEvent 代替真实网络事件,不依赖 Unity 场景、物理帧率或异步定时器。这样测试失败时,原因更可能来自事件系统本身,而不是外部执行环境。

用假事件运行一组断言

下面的程序使用 .NET 8,不依赖第三方测试框架。先执行 dotnet new console -n EventBusTests -f net8.0 创建项目,将代码替换到 Program.cs,再进入项目目录执行 dotnet run。

csharp
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();
        }
    }
}

预期输出:

text
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 是用于讲解契约的最小实现。真实项目必须将相同断言施加到正式事件总线或其测试适配器上,不能只测试一个独立的假总线,否则无法发现生产代码中的缺陷。

设计自动化测试时,应遵守以下边界:

  1. 每个测试创建独立总线实例和事件记录列表,避免上一个测试留下的订阅影响结果。
  2. 用事件唯一 ID 和确定的订阅顺序作为输入,直接比较完整回调序列,不依靠控制台日志肉眼判断。
  3. 对异步或跨线程总线使用可手动推进的队列执行器或假时钟,明确控制消息何时被处理,不使用任意时长的 Sleep 猜测完成时机。
  4. 分别验证异常传播或隔离策略,并检查失败信息确实被记录;需要并发安全时,再增加并发订阅、取消和发布的专门测试。

同步测试总线适合固定基础行为,真实线程调度和引擎生命周期则需要额外的集成测试。只要输入事件、分发契约和执行时机均可控制,事件系统的回归测试就能从偶发失败转变为稳定、可定位的断言失败。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件系统怎么写可重复测试

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

登录哪都通