多人游戏与网络同步 / 系统课时
做完大厅客户端上线前查什么
做完大厅客户端上线前查什么
大厅客户端能“正常跑通”并不等于可以上线。真正的上线验收要覆盖登录、列表、建房、进房、准备、开局和断线恢复,并且每一步都要有明确的可观察结果。本课把这些路径收敛成一套可执行的发布门禁,避免只验证最顺利的主流程。
学习目标
- 建立覆盖大厅主链路和异常恢复的上线前验收清单
- 为每个阶段定义可判定的通过条件和证据
- 用机器可读的发布门禁阻止未完成验收的版本进入上线流程
先按用户旅程检查完整链路
验收顺序应尽量贴近真实玩家行为,而不是按代码模块分组。推荐从“登录后第一次进入大厅”开始,一直走到“游戏开始或恢复失败返回可操作状态”。这样能同时暴露跨模块状态残留、路由切换和会话生命周期问题。
| 阶段 | 必查结果 | 典型失败信号 |
|---|---|---|
| 登录 | 身份建立后进入大厅,刷新后状态符合设计 | 重复登录、旧身份残留 |
| 大厅列表 | 首次加载、刷新、空态和失败态都可恢复 | 旧房间覆盖新快照 |
| 创建房间 | 成功进入新房间,失败后回到可重试状态 | 按钮长期禁用 |
| 加入房间 | 成功只进入一次,满员或关闭时给出明确反馈 | 重复请求、进入错误房间 |
| 准备状态 | 多客户端最终一致,旧事件不会回滚新状态 | 一端已准备、一端未准备 |
| 开始游戏 | 只有满足权限和准备条件时允许开始 | 非房主可开局 |
| 断线恢复 | 重连后恢复权威状态,失败则安全退出房间 | 本地残留幽灵成员 |

每一项都要有可观察证据
“点过了,看起来没问题”不能作为上线依据。关键步骤至少留下一个可重复验证的信号,例如状态仓库版本、网络响应、房间成员快照、当前路由或错误码。涉及多客户端同步时,要同时记录两个客户端,而不是只看发起操作的一端。
通过条件要写成可以判定真假的句子。例如“点击准备后按钮变绿”太依赖表现层;更稳妥的是“服务端房间版本递增,两端最终快照的该成员 ready=true,UI 与本地状态一致”。对于创建、加入和开始游戏,还要验证重复点击不会产生第二个有效请求。
把验收结果变成发布门禁
下面的脚本把人工或自动化测试的结果收敛成一个可执行门禁。实际项目中可把各项布尔值改为测试报告生成的结果;只要有一项失败,进程就以非零状态退出,CI 可以据此阻止发布。
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");
}预期输出
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、准备状态和连接身份是否属于同一会话。
只有主链路、失败恢复和跨客户端一致性都通过,发布候选版本才算具备上线条件。验收清单的价值不在于项目里有多少勾选项,而在于任何失败都能明确阻断发布,并能指出应回到哪一段流程重新验证。