多人游戏与网络同步 / 系统课时
重连成功后怎样恢复房间状态
重连成功后怎样恢复房间状态
连接重新建立并不等于房间状态已经恢复。客户端还需要重新认证、确认当前用户是否仍属于原房间,并用服务端的权威快照一次性替换本地成员、准备状态和房主信息,之后才能重新开放写操作。
学习目标
- 理解重连后为什么必须重新获取权威房间快照
- 按正确顺序恢复认证、房间成员、准备状态和房主状态
- 处理房间已解散、玩家已被移除等异常恢复结果
恢复顺序要以权威快照为边界
断线期间,其他玩家可能加入、离开、切换准备状态,房主也可能发生迁移。因此重连成功后不能只把 connection 改成 connected,也不能依赖断线前的本地对象继续操作。
推荐的恢复链路是:连接建立成功 → 重新认证 → 查询当前会话或房间归属 → 拉取完整房间快照 → 原子替换本地 Room Store → 重新接续实时事件 → 开放界面写操作。完整快照是恢复边界,它用于消除断线期间客户端遗漏的变化。

用替换而不是增量拼接恢复
恢复时最容易出错的是把新快照“合并”进旧成员表。例如断线期间玩家 u3 已经离房,如果只把服务端返回的成员追加或按字段浅合并,本地仍可能残留 u3。重连恢复应该把完整快照视为当前事实来源,直接替换房间作用域数据。
如果服务端快照带有 version,还可以把它作为后续实时事件的基线。恢复实时同步后,只接受版本高于当前快照的更新;版本不连续时再次请求快照,而不是猜测缺失事件。
下面的 JavaScript 示例模拟重新认证、获取权威快照并原子替换本地状态。
const store = {
connection: "reconnecting",
room: {
roomId: "r-101",
hostId: "u1",
version: 40,
members: [
{ userId: "u1", ready: true },
{ userId: "u2", ready: false },
{ userId: "u3", ready: false }
]
},
writesEnabled: false
};
async function reauthenticate() {
return { userId: "u2", accessToken: "<TOKEN>" };
}
async function fetchAuthoritativeRoom() {
return {
roomId: "r-101",
hostId: "u2",
version: 44,
members: [
{ userId: "u1", ready: true },
{ userId: "u2", ready: true }
]
};
}
async function recoverRoom() {
await reauthenticate();
const snapshot = await fetchAuthoritativeRoom();
// 完整快照直接替换旧 Room Scope,避免残留已离开的成员。
store.room = snapshot;
store.connection = "connected";
store.writesEnabled = true;
console.log(
`room=${store.room.roomId} host=${store.room.hostId} version=${store.room.version}`
);
console.log("members:", store.room.members.map(m => `${m.userId}:${m.ready}`));
console.log("writesEnabled:", store.writesEnabled);
}
recoverRoom();预期输出
room=r-101 host=u2 version=44
members: [ 'u1:true', 'u2:true' ]
writesEnabled: true输出说明旧成员 u3 已被权威快照移除,房主从 u1 更新为 u2,准备状态也以版本 44 的服务端结果为准。
在恢复实时事件时处理竞态
恢复快照和实时事件之间存在一个常见竞态:如果先拉快照、很久以后才恢复事件消费,那么这段间隙发生的更新可能再次丢失。更稳妥的做法取决于服务端协议能力。
如果事件流支持从版本号继续消费,可以先取得快照 version=44,再从 45 开始接收;如果服务端支持先订阅再取快照,也可以暂存订阅期间收到的事件,快照提交后仅回放版本高于快照的部分。无论采用哪种方式,都不要让旧事件覆盖更高版本的快照。
房间不存在时不要强行恢复
重连后可能发现原房间已经解散,或者当前用户已被房主移除。此时服务端应返回明确的“房间不存在”或“当前用户不属于该房间”结果。客户端应清理 Room Scope,停止房间事件消费,并返回大厅,而不是保留旧房间页面继续重试。
同样,如果重新认证失败,应进入登录或会话失效流程;如果快照请求只是临时失败,则保持 reconnecting 或 offline,继续禁用写操作,不要把旧快照重新标记为可写。
验证恢复是否真的完成
可以在测试环境中让三个玩家进入同一房间,然后让其中一个客户端断网。断网期间让其他玩家切换准备状态、离房,并触发一次房主迁移;之后恢复网络。重连客户端最终看到的成员集合、每个成员的准备状态、hostId 和 version 都应与服务端快照完全一致。
验收的关键不是“页面重新有内容”,而是本地状态已重新锚定到服务端当前事实,并且后续实时事件能从这个新基线继续推进。这样断线期间遗漏的变化不会在重连后继续污染房间状态。