游戏客户端架构 / 系统课时
事件顺序错了怎么排查
事件顺序错了怎么排查
当伤害与治疗 System 在同一帧写入同类事件时,UI 可能少刷新一次,战报却记录两次。问题往往不在事件类型,而在生产顺序、批次封口、广播与消费游标。本课把乱序、重复和遗漏拆开定位,并用可追踪编号验证修复。
学习目标
- 根据症状区分生产乱序、重复投递与漏消费。
- 设计可追踪的帧内事件标识和只读批次。
- 复现去重与顺序敏感的结果,并建立排查顺序。
先识别顺序依赖和消费症状
假设生命值上限为 100,当前 HP 为 90。同帧收到治疗 +20 和伤害 -30:先治疗会得到 100 → 70,先伤害则得到 60 → 80。因此顺序不是纯展示问题;只要计算过程含截断、冷却或状态转换,乱序就可能改变结果。
重复常来自重试后再次广播、监听器注册两次、消费者游标没有推进;遗漏常来自消费者 A 先清空共享队列、消费者 B 晚于封口才订阅,或者生产者把事件写进已结束的批次。先判断消息是否生成,再判断是否分发,最后判断是否真正生效。
给整条链路统一编号
为每条事件记录 frame、seq、eventType、entityId 与 producer;分发及处理日志另外标注 batchId 和 consumer。同一帧内,seq 应唯一且顺序语义明确。并行生产者应先汇总并按约定的 System 阶段及稳定规则合并、编号,不能依赖线程到达队列的偶然先后。
使用 (frame, seq) 作为示例事件标识,依次比对生产、封口、投递、处理四个节点的条数及标识。若封口前就缺少事件,检查触发条件与缓冲写入;若封口后只有某个消费者少一条,检查广播策略、订阅生命周期和该消费者的游标。
封口后广播同一个只读批次
可控的帧内流程为:多个 System 写入 → 等待生产阶段完成 → 封口成不可变批次 → 各消费者独立读取 → 消费结束后回收缓冲。任何一个消费者都不应该通过 pop 或 clear 决定其他消费者是否还能读取。消费期间新产生的同类事件,应进入下一约定批次而非插入当前遍历。

用可运行代码复现重复投递
以下 Python 3 示例在确定的生产阶段编号,两个消费者分别计算本地投影,不会修改 ECS 中的权威 Health。额外投递一次 seq=1,用于验证每位消费者自行去重。
from dataclasses import dataclass
@dataclass(frozen=True)
class HealthChange:
frame: int
seq: int
source: str
delta: int
queue = []
def emit(frame, source, delta):
# 在确定的生产阶段编号;并行写者需要先确定合并顺序。
queue.append(HealthChange(frame, len(queue) + 1, source, delta))
emit(42, "HealSystem", 20)
emit(42, "DamageSystem", -30)
sealed = tuple(queue) # 封口后广播同一份不可变快照
queue.clear()
def project(name, delivered):
hp, seen = 90, set()
for event in delivered:
key = (event.frame, event.seq)
if key in seen: # 丢弃本批重复投递
continue
seen.add(key)
hp = max(0, min(100, hp + event.delta))
print(f"{name}: seq={event.seq}, hp={hp}")
return hp
delivery = sealed + (sealed[0],) # 故意重复投递 seq=1
print("UI final:", project("UI", delivery))
print("Log final:", project("Log", delivery))预期输出:
UI: seq=1, hp=100
UI: seq=2, hp=70
UI final: 70
Log: seq=1, hp=100
Log: seq=2, hp=70
Log final: 70两位消费者都处理了完整批次,重复的第一条被丢弃。若交换两次 emit 的顺序,最终 HP 会是 80,说明顺序需要在生产与合并阶段定义。实际游戏中应由负责生命值的 System 决定权威状态,让 UI、战报等订阅者只观察最终状态或事件快照。
把修复变成回归检查
先固定输入、帧号和 System 调度顺序,追查每个 (frame, seq) 是否生成一次、封口一次、按预期投递、由每位消费者生效一次。再覆盖重复注册、重试投递、消费者迟到、并行生产和跨帧事件。
此示例只在单个批次内去重;若支持跨批次重放,消费者需维护有界的已处理标识或持久游标。仅按日志时间戳重排无法消除竞态,可靠修复必须同时确定业务顺序、批次边界和消费所有权。