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

同一帧多个事件谁先执行

同一帧多个事件谁先执行

一帧内命中、角色生成和界面刷新事件可能接连发生,而订阅者再次发布事件时,实际执行顺序还会改变。如果业务逻辑依赖一个没有声明的回调顺序,就容易出现状态不一致。本课通过同步派发与队列派发的对比,建立可预测的执行规则。

学习目标

  • 区分事件发布顺序、同一事件的订阅者顺序与嵌套派发顺序。
  • 识别同步回调重入带来的状态不一致和递归风险。
  • 实现帧内 FIFO 事件队列,并判断何时需要优先级或跨帧延迟。

先区分三个容易混淆的顺序

游戏事件系统中的顺序至少分为三个层面:

  • 发布顺序:不同事件按照什么时间或阶段进入系统。
  • 订阅者顺序:同一事件的多个回调按照什么规则执行。
  • 嵌套派发顺序:某个回调再次发布事件,新事件是否立即打断当前事件的处理。

假设一次命中事件有两个订阅者:A 负责更新战斗反馈并发布界面事件,B 负责记录命中统计。如果总线采用同步递归派发,执行顺序可能是 A 开始、界面事件回调、A 返回、B 执行。界面回调会在 B 完成统计之前运行。

如果改成队列派发,新事件排在等待队列尾部,当前命中事件的 A、B 可以先全部执行。两者都可能合理,关键在于系统必须声明所采用的规则。

同步嵌套派发与队列派发的执行顺序对比

同步重入为什么危险

重入指事件处理尚未结束时,同一处理链再次进入自身或相关逻辑。例如角色扣血时发布 health.changed,某个监听器又触发扣血操作,可能再次发布相同事件,形成递归调用。

这种行为会带来三个风险。首先,外层处理尚未完成,内层回调可能读取中间状态;其次,多层递归会让日志和调用栈难以追踪;最后,如果订阅者不断发布相同事件,可能造成无限递归或栈溢出。

同步派发不是错误设计。对于需要立即返回结果、处理链短且不会重入的通知,它简单直接。但如果事件允许触发其他事件,或同一帧内存在多种跨模块通知,队列派发通常更容易控制执行顺序。

在固定帧阶段集中派发

下面实现单线程帧内事件队列。Publish 只将事件放入 FIFO 队列,Flush 在指定的帧阶段统一执行回调。事件处理期间发布的新事件追加到队列尾部,不会立即递归调用订阅者。

在 .NET 8 控制台项目中,将以下代码完整替换到 Program.cs 并运行 dotnet run。

csharp
using System;
using System.Collections.Generic;

public sealed class FrameBus
{
    private readonly Dictionary<string, List<Action>> _handlers = new();
    private readonly Queue<string> _pending = new();
    private bool _flushing;

    public void Subscribe(string name, Action handler)
    {
        if (!_handlers.TryGetValue(name, out var list))
            _handlers[name] = list = new List<Action>();
        list.Add(handler);
    }

    public void Publish(string name) => _pending.Enqueue(name);

    public void Flush()
    {
        if (_flushing)
            throw new InvalidOperationException("Nested Flush");

        _flushing = true;
        try
        {
            int processed = 0;
            while (_pending.Count > 0)
            {
                // 防止处理器反复发布事件导致无限循环。
                if (++processed > 1000)
                    throw new InvalidOperationException("Event loop detected");

                string name = _pending.Dequeue();
                if (_handlers.TryGetValue(name, out var listeners))
                {
                    // 快照确保本轮遍历不受订阅表修改影响。
                    foreach (var listener in listeners.ToArray())
                        listener();
                }
            }
        }
        finally
        {
            _flushing = false;
        }
    }
}

public static class Program
{
    public static void Main()
    {
        var bus = new FrameBus();
        bus.Subscribe("hit", () =>
        {
            Console.WriteLine("Hit A");
            bus.Publish("ui");
        });
        bus.Subscribe("hit", () => Console.WriteLine("Hit B"));
        bus.Subscribe("spawn", () => Console.WriteLine("Spawn"));
        bus.Subscribe("ui", () => Console.WriteLine("UI"));

        bus.Publish("hit");
        bus.Publish("spawn");
        // 模拟在本帧固定的派发阶段处理全部待发事件。
        bus.Flush();
    }
}

预期输出:

text
Hit A
Hit B
Spawn
UI

执行开始前,队列已有 hit 和 spawn。处理 hit 时,A 发布的 ui 被追加到 spawn 后方,因此两个命中订阅者先执行,随后处理生成事件,最后才执行界面事件。

此处同一事件的订阅者按 List<Action> 的注册顺序执行,这是本例明确采用的实现规则,而不是所有事件系统天然具备的保证。Flush 中的处理数量上限用于发现异常事件循环;生产系统还应记录故障上下文并规定未处理队列如何恢复。

什么时候需要显式优先级或跨帧延迟

FIFO 只能保证队列中事件的先入先出,无法表达所有业务依赖。如果伤害结算必须早于死亡判断,死亡判断又必须早于奖励发放,最好通过明确的同步业务流程保证顺序,再用事件通知其他模块,而不是寄希望于订阅注册位置。

需要跨模块阶段顺序时,可以将每帧处理划分为状态更新、游戏规则结算、表现通知等阶段,在阶段边界派发对应事件。确实需要优先级时,应定义稳定的排序规则,例如优先级相同再按注册序号排序,并通过测试固定契约。

本例在同一次 Flush 中处理新入队的事件,因此这些事件仍可能在当前帧执行。如果要求事件最早下一帧才能触发,必须使用双缓冲队列:本帧只消费开始时交换出的读取队列,新事件始终写入另一队列,留待下一帧处理。

验证顺序策略时,至少覆盖同一事件多个订阅者、回调中发布新事件、处理器循环发布事件,以及一帧中多次发布不同事件的情况。执行顺序应由明确的业务阶段与派发契约决定,而不应成为隐藏在回调注册顺序中的偶然结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

同一帧多个事件谁先执行

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

登录哪都通