多人游戏与网络同步 / 系统课时
两个客户端状态不一致怎么复现
两个客户端状态不一致怎么复现
线上偶发的“一个人已准备、另一个人仍显示未准备”最难排查的地方,是异常通常无法稳定重现。本课把网络条件变成可控输入,用固定的延迟、丢包和重复事件计划,让两个客户端稳定走到不同状态,再用版本、事件 ID 与快照记录定位分叉点。
学习目标
- 把随机的状态不同步问题改造成可重复执行的实验
- 用延迟、乱序、丢包和重复事件构造最小复现场景
- 根据事件版本、接收顺序和最终状态判断问题发生在哪一层
先固定初始状态和判定标准
复现前先把变量收紧。两个客户端必须从同一个房间快照开始,例如 version=10,成员 u2.ready=false。之后只注入两条事件:v11 把 ready 改为 true,v12 再改回 false。这样一旦最终结果不同,就能明确是事件传输或提交规则导致,而不是业务输入不同。
一次有效复现至少记录四类信息:客户端标识、事件 ID、事件版本、应用前后的本地版本。不要只截最终 UI,因为“显示不同”只是结果,真正有价值的是哪个客户端在哪一条事件之后第一次分叉。

用可控注入器稳定制造异常
下面的 Node.js 脚本不依赖第三方包。它把服务端事件和每个客户端的投递计划写死,因此每次运行都会得到相同结果。客户端故意采用“收到什么就覆盖什么”的错误策略,方便观察乱序和丢包怎样制造不一致。
const baseState = { version: 10, ready: false };
const e11 = { id: "e11", version: 11, ready: true };
const e12 = { id: "e12", version: 12, ready: false };
function replay(name, plan) {
const state = { ...baseState };
for (const item of plan) {
if (item.drop) {
console.log(`${name} DROP ${item.event.id}`);
continue;
}
const event = item.event;
state.version = event.version;
state.ready = event.ready;
console.log(`${name} APPLY ${event.id} v${event.version} ready=${event.ready}`);
}
return state;
}
const scenarios = {
reorder: {
a: [{ event: e11 }, { event: e12 }],
b: [{ event: e12 }, { event: e11 }],
},
drop: {
a: [{ event: e11 }, { event: e12 }],
b: [{ event: e11 }, { event: e12, drop: true }],
},
duplicate: {
a: [{ event: e11 }, { event: e12 }],
b: [{ event: e11 }, { event: e11 }, { event: e12 }],
},
};
for (const [scenario, plans] of Object.entries(scenarios)) {
console.log(`\n[${scenario}]`);
const a = replay("A", plans.a);
const b = replay("B", plans.b);
console.log(`FINAL A v${a.version} ready=${a.ready}`);
console.log(`FINAL B v${b.version} ready=${b.ready}`);
}预期输出
[reorder]
A APPLY e11 v11 ready=true
A APPLY e12 v12 ready=false
B APPLY e12 v12 ready=false
B APPLY e11 v11 ready=true
FINAL A v12 ready=false
FINAL B v11 ready=true
[drop]
A APPLY e11 v11 ready=true
A APPLY e12 v12 ready=false
B APPLY e11 v11 ready=true
B DROP e12
FINAL A v12 ready=false
FINAL B v11 ready=true
[duplicate]
A APPLY e11 v11 ready=true
A APPLY e12 v12 ready=false
B APPLY e11 v11 ready=true
B APPLY e11 v11 ready=true
B APPLY e12 v12 ready=false
FINAL A v12 ready=false
FINAL B v12 ready=false这个结果说明三类问题的性质不同:乱序会让旧事件覆盖新状态;丢包会让客户端永久停在旧版本;重复事件不一定立刻造成错值,但如果事件带有计数、增减成员或一次性副作用,就可能重复执行。
让复现更接近真实线上环境
真正接入客户端时,不应直接修改业务状态,而是在“网络消息进入状态仓库之前”放一个故障注入层。它只负责延迟、丢弃、复制和重排消息,业务代码保持不变。这样复现出来的问题才有诊断价值。
建议为每次实验固定一个场景编号,例如 reorder-ready-01,并同时保存服务端事件日志、两个客户端接收日志和最后一次完整房间快照。延迟值也应固定,例如让 v11 延迟 800 ms、v12 延迟 100 ms;不要每次随机抖动,否则同一个测试名称可能走出不同结果。
从第一次分叉定位根因
看到两个客户端最终值不同后,按同一顺序检查:先比较双方收到的事件集合,再比较接收顺序,然后比较提交规则,最后才看 UI 映射。若两端收到的事件不同,优先查订阅、断线重连和消息丢失;若事件相同但顺序不同,查版本守卫;若状态仓库一致而界面不同,再查选择器、缓存和渲染。
对于带单调版本号的房间状态,客户端至少应拒绝 event.version <= localVersion 的旧事件;发现版本跳跃时则请求权威快照,而不是继续猜测中间状态。把异常网络变成固定输入后,原本“偶现”的线上问题就会变成可以重复、对比和回归验证的测试用例。