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

做完大厅客户端上线前查什么

做完大厅客户端上线前查什么

大厅客户端能“正常跑通”并不等于可以上线。真正的上线验收要覆盖登录、列表、建房、进房、准备、开局和断线恢复,并且每一步都要有明确的可观察结果。本课把这些路径收敛成一套可执行的发布门禁,避免只验证最顺利的主流程。

学习目标

  • 建立覆盖大厅主链路和异常恢复的上线前验收清单
  • 为每个阶段定义可判定的通过条件和证据
  • 用机器可读的发布门禁阻止未完成验收的版本进入上线流程

先按用户旅程检查完整链路

验收顺序应尽量贴近真实玩家行为,而不是按代码模块分组。推荐从“登录后第一次进入大厅”开始,一直走到“游戏开始或恢复失败返回可操作状态”。这样能同时暴露跨模块状态残留、路由切换和会话生命周期问题。

阶段 必查结果 典型失败信号
登录 身份建立后进入大厅,刷新后状态符合设计 重复登录、旧身份残留
大厅列表 首次加载、刷新、空态和失败态都可恢复 旧房间覆盖新快照
创建房间 成功进入新房间,失败后回到可重试状态 按钮长期禁用
加入房间 成功只进入一次,满员或关闭时给出明确反馈 重复请求、进入错误房间
准备状态 多客户端最终一致,旧事件不会回滚新状态 一端已准备、一端未准备
开始游戏 只有满足权限和准备条件时允许开始 非房主可开局
断线恢复 重连后恢复权威状态,失败则安全退出房间 本地残留幽灵成员

多人大厅客户端上线前发布门禁流程

每一项都要有可观察证据

“点过了,看起来没问题”不能作为上线依据。关键步骤至少留下一个可重复验证的信号,例如状态仓库版本、网络响应、房间成员快照、当前路由或错误码。涉及多客户端同步时,要同时记录两个客户端,而不是只看发起操作的一端。

通过条件要写成可以判定真假的句子。例如“点击准备后按钮变绿”太依赖表现层;更稳妥的是“服务端房间版本递增,两端最终快照的该成员 ready=true,UI 与本地状态一致”。对于创建、加入和开始游戏,还要验证重复点击不会产生第二个有效请求。

把验收结果变成发布门禁

下面的脚本把人工或自动化测试的结果收敛成一个可执行门禁。实际项目中可把各项布尔值改为测试报告生成的结果;只要有一项失败,进程就以非零状态退出,CI 可以据此阻止发布。

js
const checks = [
  ["login", true],
  ["lobby-list", true],
  ["create-room", true],
  ["join-room", true],
  ["ready-sync", true],
  ["start-game-permission", true],
  ["reconnect-recovery", false],
];

const failed = checks.filter(([, passed]) => !passed);

for (const [name, passed] of checks) {
  console.log(`${passed ? "PASS" : "FAIL"} ${name}`);
}

if (failed.length > 0) {
  console.error(`BLOCK RELEASE: ${failed.length} check(s) failed`);
  process.exitCode = 1;
} else {
  console.log("RELEASE CANDIDATE APPROVED");
}

预期输出

text
PASS login
PASS lobby-list
PASS create-room
PASS join-room
PASS ready-sync
PASS start-game-permission
FAIL reconnect-recovery
BLOCK RELEASE: 1 check(s) failed

当 reconnect-recovery 修复并改为 true 后,最后一行应变为 RELEASE CANDIDATE APPROVED,进程退出码为 0。实际 CI 中不要靠修改源码来填写结果,而应由 E2E 测试、集成测试或验收报告生成这些布尔值。

异常路径不能只测一个错误提示

发布前至少覆盖三类异常:请求失败、权限或业务拒绝、连接中断。它们的共同验收标准不是“弹出错误”,而是失败后客户端仍处于可解释、可继续操作的状态。例如建房失败后回到可编辑状态,加入满员房间后仍留在大厅,开局被拒绝后房间成员和准备状态不能被清空。

断线恢复尤其要检查边界:恢复成功时,本地房间数据应以服务端权威快照为准;确认已经不在房间时,应清掉房间作用域数据但保留登录态和大厅态;恢复超时也不能让界面长期停在“连接中”。

上线前最后看一致性而不是功能数量

最后一轮验收应重点寻找“每个功能单独都对,但串起来后状态错了”的问题。连续执行创建房间、离开、加入另一房间、准备、取消准备、断线重连,再检查当前房间 ID、成员表、房主 ID、准备状态和连接身份是否属于同一会话。

只有主链路、失败恢复和跨客户端一致性都通过,发布候选版本才算具备上线条件。验收清单的价值不在于项目里有多少勾选项,而在于任何失败都能明确阻断发布,并能指出应回到哪一段流程重新验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

做完大厅客户端上线前查什么

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

登录哪都通