多人游戏与网络同步 / 系统课时
离开房间时哪些本地数据要清掉
离开房间时哪些本地数据要清掉
离房不是只把 roomId 设为空。成员列表、准备状态、邀请弹窗和实时订阅如果继续留在客户端,下一次进房就可能看到旧成员、旧按钮状态,甚至收到上一房间的事件。本篇用“房间作用域”划清清理边界,并用一个可运行示例验证离房后的本地状态。
学习目标
- 区分应随离房清理的房间临时数据与应继续保留的账号、大厅数据
- 在离房成功后按稳定顺序取消订阅、重置房间状态并回到大厅
- 验证二次进房不会继承上一房间的成员、准备状态或事件句柄
先按作用域决定清不清
判断一份本地数据是否要在离房时清掉,最可靠的问题不是“它现在有没有用”,而是“它是否只对当前房间有效”。只要答案是是,就应在房间生命周期结束时统一失效。
应清理的典型数据包括:当前 roomId、成员列表、自己的 ready 状态、其他成员 ready 状态、房间内邀请或踢出提示、房主权限快照、房间聊天未读数、房间级错误,以及 WebSocket 或事件总线的订阅句柄。
通常不应一起清掉的是登录凭据、当前用户资料、大厅筛选条件、已加载的大厅列表,以及跨房间都有效的全局连接对象。把这些也重置,会让一次离房变成一次“半登出”,增加无必要的重新请求。

清理顺序要先断事件再丢状态
离房成功后建议先停止房间事件订阅,再重置房间状态,最后切换到大厅视图。原因很直接:如果先把 roomId 清空,而旧订阅仍可能收到 memberJoined、readyChanged,事件处理器就可能把已经清掉的数据重新写回来。
如果离房接口失败,则不要立刻把本地房间清空。此时服务端可能仍认为玩家在房间内,应保留当前状态并显示失败提示,让用户重试。只有确认服务端离房成功,或收到“你已经不是该房间成员”这类可视为幂等成功的结果后,才进入完整清理流程。
用房间作用域对象集中释放
下面用 Node.js 模拟一个最小客户端 store。所有只属于当前房间的数据放进 room,订阅释放函数单独保存。leaveRoomLocally 会先调用取消订阅,再一次性恢复房间初始值。
const initialRoomState = () => ({
roomId: null,
members: [],
readyByUserId: {},
invitation: null,
error: null,
});
const store = {
auth: { userId: "u-1", accessToken: "token-demo" },
lobby: { region: "us-west", filter: "open" },
room: {
roomId: "room-a",
members: ["u-1", "u-2"],
readyByUserId: { "u-1": true, "u-2": false },
invitation: { fromUserId: "u-3" },
error: "previous transient error",
},
unsubscribeRoomEvents: () => {
console.log("room subscription disposed");
},
};
function leaveRoomLocally(clientStore) {
const dispose = clientStore.unsubscribeRoomEvents;
clientStore.unsubscribeRoomEvents = null;
if (dispose) {
dispose();
}
clientStore.room = initialRoomState();
}
leaveRoomLocally(store);
console.log(JSON.stringify({
authUser: store.auth.userId,
lobbyRegion: store.lobby.region,
room: store.room,
hasRoomSubscription: store.unsubscribeRoomEvents !== null,
}, null, 2));预期输出
room subscription disposed
{
"authUser": "u-1",
"lobbyRegion": "us-west",
"room": {
"roomId": null,
"members": [],
"readyByUserId": {},
"invitation": null,
"error": null
},
"hasRoomSubscription": false
}这个结果同时验证两件事:房间临时数据和订阅被清掉,而账号与大厅状态仍然保留。实际项目可以把 initialRoomState() 做成 reducer 的初始值、store 的 reset action,或状态机离开 InRoom 时的退出动作。
验收时专门测二次进房
单次离房看起来正常,并不能证明清理边界正确。更有效的验收路径是“进入 A 房间 → 产生临时状态 → 离开 → 进入 B 房间”。进入 B 后检查成员列表、ready 状态、邀请提示和房间错误都只来自 B,同时确认 A 的事件不再触发任何 store 更新。
还要检查重复执行清理是否安全。网络重试、路由卸载和服务端离房确认可能先后触发同一套释放逻辑,因此取消订阅和重置状态最好设计成幂等操作:第一次完成清理,第二次执行也不会抛错或破坏大厅状态。
把离房理解为“结束一个房间作用域”,清理规则就会稳定很多:只销毁当前房间独占的数据和资源,跨房间仍有效的状态继续保留。这样下一次创建或加入房间时,客户端拿到的是干净的新房间上下文,而不是上一房间的残留快照。