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

离开房间时哪些本地数据要清掉

离开房间时哪些本地数据要清掉

离房不是只把 roomId 设为空。成员列表、准备状态、邀请弹窗和实时订阅如果继续留在客户端,下一次进房就可能看到旧成员、旧按钮状态,甚至收到上一房间的事件。本篇用“房间作用域”划清清理边界,并用一个可运行示例验证离房后的本地状态。

学习目标

  • 区分应随离房清理的房间临时数据与应继续保留的账号、大厅数据
  • 在离房成功后按稳定顺序取消订阅、重置房间状态并回到大厅
  • 验证二次进房不会继承上一房间的成员、准备状态或事件句柄

先按作用域决定清不清

判断一份本地数据是否要在离房时清掉,最可靠的问题不是“它现在有没有用”,而是“它是否只对当前房间有效”。只要答案是是,就应在房间生命周期结束时统一失效。

应清理的典型数据包括:当前 roomId、成员列表、自己的 ready 状态、其他成员 ready 状态、房间内邀请或踢出提示、房主权限快照、房间聊天未读数、房间级错误,以及 WebSocket 或事件总线的订阅句柄。

通常不应一起清掉的是登录凭据、当前用户资料、大厅筛选条件、已加载的大厅列表,以及跨房间都有效的全局连接对象。把这些也重置,会让一次离房变成一次“半登出”,增加无必要的重新请求。

离房时房间作用域数据的清理边界

清理顺序要先断事件再丢状态

离房成功后建议先停止房间事件订阅,再重置房间状态,最后切换到大厅视图。原因很直接:如果先把 roomId 清空,而旧订阅仍可能收到 memberJoined、readyChanged,事件处理器就可能把已经清掉的数据重新写回来。

如果离房接口失败,则不要立刻把本地房间清空。此时服务端可能仍认为玩家在房间内,应保留当前状态并显示失败提示,让用户重试。只有确认服务端离房成功,或收到“你已经不是该房间成员”这类可视为幂等成功的结果后,才进入完整清理流程。

用房间作用域对象集中释放

下面用 Node.js 模拟一个最小客户端 store。所有只属于当前房间的数据放进 room,订阅释放函数单独保存。leaveRoomLocally 会先调用取消订阅,再一次性恢复房间初始值。

js
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));

预期输出

text
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 更新。

还要检查重复执行清理是否安全。网络重试、路由卸载和服务端离房确认可能先后触发同一套释放逻辑,因此取消订阅和重置状态最好设计成幂等操作:第一次完成清理,第二次执行也不会抛错或破坏大厅状态。

把离房理解为“结束一个房间作用域”,清理规则就会稳定很多:只销毁当前房间独占的数据和资源,跨房间仍有效的状态继续保留。这样下一次创建或加入房间时,客户端拿到的是干净的新房间上下文,而不是上一房间的残留快照。

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

目录与阅读设置

阅读设置

17

记录一个想法

离开房间时哪些本地数据要清掉

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

登录哪都通