多人游戏与网络同步 / 系统课时

两个客户端状态不一致怎么复现

两个客户端状态不一致怎么复现

线上偶发的“一个人已准备、另一个人仍显示未准备”最难排查的地方,是异常通常无法稳定重现。本课把网络条件变成可控输入,用固定的延迟、丢包和重复事件计划,让两个客户端稳定走到不同状态,再用版本、事件 ID 与快照记录定位分叉点。

学习目标

  • 把随机的状态不同步问题改造成可重复执行的实验
  • 用延迟、乱序、丢包和重复事件构造最小复现场景
  • 根据事件版本、接收顺序和最终状态判断问题发生在哪一层

先固定初始状态和判定标准

复现前先把变量收紧。两个客户端必须从同一个房间快照开始,例如 version=10,成员 u2.ready=false。之后只注入两条事件:v11 把 ready 改为 true,v12 再改回 false。这样一旦最终结果不同,就能明确是事件传输或提交规则导致,而不是业务输入不同。

一次有效复现至少记录四类信息:客户端标识、事件 ID、事件版本、应用前后的本地版本。不要只截最终 UI,因为“显示不同”只是结果,真正有价值的是哪个客户端在哪一条事件之后第一次分叉。

两个客户端在可控网络异常下产生状态分叉的时序

用可控注入器稳定制造异常

下面的 Node.js 脚本不依赖第三方包。它把服务端事件和每个客户端的投递计划写死,因此每次运行都会得到相同结果。客户端故意采用“收到什么就覆盖什么”的错误策略,方便观察乱序和丢包怎样制造不一致。

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}`);
}

预期输出

text
[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 的旧事件;发现版本跳跃时则请求权威快照,而不是继续猜测中间状态。把异常网络变成固定输入后,原本“偶现”的线上问题就会变成可以重复、对比和回归验证的测试用例。

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

目录与阅读设置

阅读设置

17

记录一个想法

两个客户端状态不一致怎么复现

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

登录哪都通