多人游戏与网络同步 / 系统课时
用战斗回放复现不同步问题
用战斗回放复现不同步问题
不同步最难查的不是“看到了错误”,而是无法重建错误发生前后的输入、网络与权威状态。本篇通过记录可重放的战斗事件,在本地按相同顺序重建现场,让一次线上偶发不同步变成可重复、可对比的调试样本。
学习目标
- 设计最小可用的战斗回放记录,保留输入与关键权威事件。
- 用固定事件序列重建一次异常战斗,并定位客户端与服务端首次分歧点。
- 通过回放比对输入、状态与命中结果,缩短弱网同步问题的定位路径。
先确定回放要记录什么
回放不是把每一帧的完整画面录下来,而是保存足以重建战斗规则的事件。最小集合通常包括 matchId、tick、commandSeq、actorId、输入指令,以及施法接受、命中、伤害结算、生成和销毁等关键权威事件。
为了让同一场战斗可以稳定重建,事件必须带有明确的顺序键。tick 用来描述服务器模拟位置,commandSeq 用来保持同一客户端输入顺序,eventId 则用于识别重试或重复投递。不要只依赖日志时间,因为日志落盘顺序不一定等于模拟顺序。

把输入和权威事件写入回放文件
工程上可以先采用一条事件一行的 JSON Lines 文件。下面的示例用内存事件列表模拟一次很小的战斗,并写入 replay.jsonl;真实项目中只需要把事件来源替换为实际网络层和战斗服日志。
import json
from pathlib import Path
replay = [
{"tick": 1200, "type": "input", "commandSeq": 41, "actorId": "player-7", "input": {"moveX": 1, "cast": "slash"}},
{"tick": 1201, "type": "cast_accepted", "eventId": "evt-9001", "actorId": "player-7", "skillId": "slash"},
{"tick": 1202, "type": "hit_resolved", "eventId": "evt-9002", "targetId": "enemy-3", "damage": 120},
]
path = Path("replay.jsonl")
with path.open("w", encoding="utf-8") as f:
for event in replay:
f.write(json.dumps(event, ensure_ascii=False) + "\n")
print(f"saved {len(replay)} events to {path}")预期结果
saved 3 events to replay.jsonl这个格式的关键不是 JSON Lines 本身,而是事件可被确定性排序。实际系统还应记录协议版本和规则版本,例如 replaySchemaVersion、战斗配置版本或技能数据版本,避免今天的规则去解释昨天的事件。
按同样顺序重建问题现场
回放执行器应先按模拟顺序读取输入,再让战斗规则运行,最后将重新计算出的关键结果与原始权威事件比较。定位时不要一开始比较最终血量,而应逐 tick 检查位置、速度、技能状态、目标关系和命中结果,找到第一次分歧。
可以把定位结果写成“期望值”和“重放值”两列。例如原始权威事件在 tick=1202 命中 enemy-3,而重放在同 tick 未命中,那么需要继续向前检查目标位置、攻击状态和碰撞查询输入。这样可以把“最终伤害不一致”缩小成一个具体的状态变化。
区分输入问题和状态问题
回放最大的价值是切断网络噪声。若相同 commandSeq 的输入在回放中一致,但状态从某个 tick 开始分叉,优先检查确定性模拟、浮点计算、随机数种子、配置版本和实体生命周期。若输入序列本身就不同,则应回到网络重试、丢包、去重和客户端发送逻辑排查。
对于随机战斗逻辑,必须记录随机种子或可重放的随机序列;对于依赖时间的逻辑,尽量使用回放中的 tick 或服务器时间,而不是直接读取当前系统时钟。否则同一份回放可能每次都得到不同结果。
验证回放确实能复现
一次合格的回放样本至少要满足三点:输入序列完整、规则版本明确、异常能在固定 tick 附近稳定出现。可以在 CI 中把历史故障样本作为回归用例,每次修改战斗同步代码后自动重放,并比较关键权威事件。
import json
from pathlib import Path
expected = ["cast_accepted", "hit_resolved"]
actual = []
for line in Path("replay.jsonl").read_text(encoding="utf-8").splitlines():
event = json.loads(line)
if event["type"] in expected:
actual.append(event["type"])
assert actual == expected, f"replay diverged: {actual}"
print("replay verification passed")预期结果
replay verification passed当回放能够稳定重建同一个异常 tick 后,排障目标就从“猜测网络为什么不同步”变成“解释这一 tick 为什么第一次分叉”。这通常比继续翻大量客户端截图或零散日志更快,也更适合沉淀成自动化回归样本。