多人游戏与网络同步 / 系统课时
服务器解散房间客户端怎么收口
服务器解散房间客户端怎么收口
房间被服务器主动结束时,客户端不能只弹一个提示框,还要停止房间内操作、清理房间作用域状态、处理重复终止事件并安全返回大厅。本节把房主离开、房间关闭和维护停服统一为一个可幂等执行的收口流程。
学习目标
- 把多种服务端结束原因归一为统一的房间终止事件
- 设计从房间态到大厅态的单向、可重复调用收口流程
- 明确哪些状态应清理,哪些登录与大厅状态必须保留
先统一“为什么结束”,再统一“怎么结束”
服务器可能因为房主离开而解散房间,也可能显式关闭房间,或在维护停服时批量终止会话。客户端界面文案可以不同,但状态处理不应分成三套互相独立的逻辑。
推荐把服务端消息归一为 ROOM_TERMINATED,并保留 reason,例如 HOST_LEFT、ROOM_CLOSED、MAINTENANCE。业务层只负责把原因映射为用户可理解的提示;状态层始终执行同一条收口链:冻结房间操作、退出实时订阅、清理房间作用域数据、切回大厅。

收口必须是幂等的
真实网络环境中,同一个终止事实可能通过多条路径到达:先收到 ROOM_TERMINATED,随后连接关闭;或者维护广播与房间关闭事件几乎同时到达。如果每个回调都执行一次路由和清理,就可能出现重复跳转、重复提示,甚至在新大厅状态上再次清空数据。
因此收口函数要有明确状态门。只有 phase === "inRoom" 时允许第一次进入 closing;一旦处于 closing 或已经回到 lobby,后续终止事件只记录或忽略,不再重复执行副作用。
清理房间作用域,不要误伤全局状态
应清理的数据通常包括 roomId、成员表、准备状态、hostId、房间内邀请、房间级请求状态和房间事件订阅。登录凭据、当前用户资料、大厅筛选条件以及可复用的大厅连接属于更高作用域,不能因为房间结束就一并删除。
如果你的连接模型是“房间独占 WebSocket”,收口时关闭它;如果大厅和房间共享同一条连接,则只取消房间频道订阅,不要把共享连接直接断掉。这个边界决定了用户返回大厅后是否需要无意义地重新登录或重新建链。
用一个终止处理器执行副作用
下面示例使用一个终止处理器处理不同结束原因,并用 phase 保证幂等。为便于验证,订阅取消和路由都用可观察的日志代替,状态变化与真实客户端一致。
const client = {
phase: "inRoom",
authToken: "token-abc",
lobbyList: ["lobby-a"],
room: {
roomId: "room-42",
members: ["u1", "u2"],
readyByUser: { u1: true, u2: false },
hostId: "u1"
},
roomSubscribed: true
};
const reasonText = {
HOST_LEFT: "房主离开,房间已解散",
ROOM_CLOSED: "房间已被服务器关闭",
MAINTENANCE: "服务器维护,房间已结束"
};
function terminateRoom(reason) {
if (client.phase !== "inRoom") {
console.log(`ignore duplicate termination: ${reason}`);
return;
}
client.phase = "closing";
console.log(reasonText[reason] ?? "房间已结束");
// 先停止房间事件,再清理房间作用域,避免清理期间继续写入。
client.roomSubscribed = false;
client.room = null;
client.phase = "lobby";
console.log("route: /lobby");
}
terminateRoom("HOST_LEFT");
terminateRoom("MAINTENANCE");
console.log(
JSON.stringify({
phase: client.phase,
authToken: client.authToken,
lobbyList: client.lobbyList,
room: client.room,
roomSubscribed: client.roomSubscribed
})
);预期输出
房主离开,房间已解散
route: /lobby
ignore duplicate termination: MAINTENANCE
{"phase":"lobby","authToken":"token-abc","lobbyList":["lobby-a"],"room":null,"roomSubscribed":false}这个例子特意保留了 authToken 和 lobbyList,用于验证收口只影响房间作用域。实际项目中还应让房间按钮在进入 closing 后立即不可用,避免用户在终止流程中继续发送 Ready、Kick 或 Start Game 请求。
维护停服还要区分是否能留在大厅
MAINTENANCE 不一定只影响单个房间。如果服务端明确表示整个大厅服务都将不可用,终止处理器可以先完成房间清理,再进入一个全局 serviceUnavailable 状态,而不是强行路由到仍然不可用的大厅。关键是让“房间终止”与“全局服务不可用”成为两层状态,而不是把所有异常都塞进一个 room=null。
客户端收口的判定标准不是“页面已经离开房间”,而是房间级副作用已经停止、房间数据已经清空、重复事件不会重复执行,并且全局会话仍处于正确状态。做到这几点,服务端无论以哪种原因结束房间,客户端都会沿同一条可验证路径稳定退出。