多人游戏与网络同步 / 系统课时
为什么房间列表看到旧玩家
为什么房间列表看到旧玩家
房间列表里已经离开的玩家仍然存在,通常不是单纯的“前端没刷新”,而是成员数据在本地缓存、刷新触发或服务端快照中的某一层失去时效性。本课按从客户端到服务端的顺序定位,并建立不会被旧响应覆盖的新鲜度规则。
学习目标
- 区分本地状态残留、刷新时机缺失与服务端快照陈旧三类问题
- 用版本号和“快照替换”避免旧请求覆盖新成员列表
- 建立从复现到修复后的验证顺序
先确认旧数据停在哪一层
房间列表通常不是直接渲染数据库成员表,而是经过“接口响应 → 客户端 store/cache → 列表组件”后才显示。若服务端还做房间快照缓存,链路会再多一层。看到旧玩家时,先用同一个房间 ID 对比三份数据:界面当前值、最新接口响应、服务端权威成员集合。

如果接口已经返回正确玩家,而界面仍有旧玩家,问题在客户端状态更新;如果接口本身就是旧的,再继续查请求是否真的发出,以及服务端快照是否在成员变化后重建。这样可以避免一开始就同时改轮询、缓存和数据库逻辑。
客户端不要把权威快照当增量合并
成员列表接口若声明返回“当前完整成员集合”,客户端收到后应替换该房间的 players,而不是只把新玩家追加进去。另一个常见问题是并发刷新:较早发出的请求最后才返回,把已经更新的列表重新覆盖成旧版本。
下面的可运行示例用 revision 表示服务端快照版本,只接受不旧于当前版本的数据:
let currentRoom = { id: "room-7", revision: 0, players: [] };
function applySnapshot(snapshot) {
if (snapshot.id !== currentRoom.id) return;
if (snapshot.revision < currentRoom.revision) return;
// 完整快照必须整体替换,不能与旧 players 做并集合并。
currentRoom = {
id: snapshot.id,
revision: snapshot.revision,
players: [...snapshot.players],
};
}
applySnapshot({ id: "room-7", revision: 10, players: ["Alice", "Bob"] });
applySnapshot({ id: "room-7", revision: 11, players: ["Alice"] });
applySnapshot({ id: "room-7", revision: 9, players: ["Alice", "Bob", "Carol"] });
console.log(currentRoom.revision);
console.log(currentRoom.players.join(","));预期输出
11
Alice实际项目不一定使用数字版本,也可以使用服务端生成的单调序列、事件 offset 或能可靠比较新旧的版本标识。关键不是字段名,而是旧响应不能覆盖新状态。
检查刷新时机和服务端快照
客户端至少应在进入大厅、创建或加入房间成功、离开房间成功,以及收到成员变更推送后更新相关房间。若使用轮询,应避免多个轮询请求重叠;切换页面后还要取消不再需要的请求,防止旧页面响应写回共享 store。
服务端若缓存房间列表或房间详情,则成员变更必须同步推进快照版本或失效对应缓存。最容易遗漏的是“离房成功只改了成员表,却没有清掉房间摘要缓存”,于是数据库正确、接口仍旧。
| 观察结果 | 更可能的根因 | 修复方向 |
|---|---|---|
| 接口正确,UI 错 | 本地 merge、选择器缓存或旧响应覆盖 | 完整替换并比较版本 |
| 手动刷新后正确 | 自动刷新触发缺失 | 在 join/leave/推送后刷新 |
| 接口持续返回旧成员 | 服务端快照或缓存未失效 | 成员变更时重建或失效缓存 |
| 偶发回退到旧名单 | 并发请求乱序 | 取消旧请求或拒绝旧版本 |
用一次可重复场景验证修复
准备两个客户端 A、B 加入同一房间,确认列表显示两人;让 B 离房,同时记录 A 侧网络请求和服务端成员数据。修复后应满足:服务端权威集合先变为只含 A,随后返回给 A 的最新快照也只含 A,客户端 store 最终保持该版本,之后即使有更旧请求返回也不会把 B 加回来。
若这四层结果能够持续一致,问题才算真正关闭。只靠“重新打开页面后看起来正常”无法证明缓存失效和乱序响应已经处理。