多人游戏与网络同步 / 系统课时
一次进房请求怎样穿过客户端
一次进房请求怎样穿过客户端
点击“进入房间”看似只是一次请求,实际会依次经过界面事件、客户端动作、网络请求、状态更新和路由切换。把这条链路拆开,才能避免重复提交、先跳页面后失败、旧响应覆盖新状态等常见问题。
学习目标
- 说清一次进房操作从点击到房间页渲染的完整链路。
- 区分请求中的临时状态、服务端确认状态和界面导航。
- 用可运行示例验证成功响应应先更新状态,再触发界面切换。
链路不是一次 fetch
进房流程至少包含五个参与者:按钮或页面、业务动作层、API 层、客户端状态容器和路由或视图层。成功路径应该保持单向流动,失败时则停在当前页面并恢复可操作状态。

如果按钮点击后立即跳转,再等请求结果,失败时就需要把页面和状态一起回滚;如果请求成功后只导航但没有先落状态,房间页又会短暂读到空数据。更稳定的顺序是“发起请求 → 接收确认 → 写入状态 → 导航”。
把请求分成四段
客户端可以把一次进房动作拆成四段职责:
- 界面层只收集
roomId并触发joinRoom,同时禁用重复点击。 - 动作层把
joinStatus设为pending,调用 API,并统一处理成功或失败。 - API 层只负责协议细节,例如 URL、方法、凭据与错误码,不负责跳页面。
- 状态写入成功后,路由层再进入房间页;房间页只读取已经确认的房间快照。
这种拆分的重点不是文件数量,而是副作用顺序。页面事件可以取消,网络会失败,响应可能延迟,但只有服务端确认后的房间状态应该成为新的稳定状态。
用可运行示例验证顺序
下面示例使用 Node.js 18+ 内置的 http 和 fetch,在同一进程中启动一个最小模拟服务端,再让客户端执行进房动作。这样可以直接观察“请求成功 → 更新状态 → 切换页面”的顺序。
const http = require("node:http");
const store = {
joinStatus: "idle",
room: null,
route: "/lobby"
};
const server = http.createServer((req, res) => {
if (req.method === "POST" && req.url === "/api/rooms/room-42/join") {
res.writeHead(200, { "content-type": "application/json" });
res.end(JSON.stringify({
roomId: "room-42",
members: ["u-7", "u-9"],
leaderId: "u-7"
}));
return;
}
res.writeHead(404);
res.end();
});
server.listen(0, "127.0.0.1", async () => {
const { port } = server.address();
async function joinRoom(roomId) {
store.joinStatus = "pending";
const response = await fetch(
`http://127.0.0.1:${port}/api/rooms/${roomId}/join`,
{ method: "POST" }
);
if (!response.ok) {
store.joinStatus = "error";
throw new Error(`join failed: ${response.status}`);
}
store.room = await response.json();
store.joinStatus = "success";
store.route = `/rooms/${store.room.roomId}`;
}
try {
await joinRoom("room-42");
console.log(store.joinStatus);
console.log(store.room.roomId);
console.log(store.route);
} finally {
server.close();
}
});预期输出
success
room-42
/rooms/room-42示例里端口由操作系统动态分配,实际值不同不影响结果。真实客户端还应在请求期间给按钮增加禁用或加载状态,防止用户连续点击产生多个并发进房请求。
失败时不要切界面
进房失败通常不是一个统一的“网络错误”。例如房间已满可能返回 409,权限不足可能是 403,认证过期可能是 401。客户端动作层应把这些结果转换成稳定的错误状态,而不是让每个按钮自己猜测。
如果用户在等待期间又选择了另一个房间,还要防止旧响应覆盖新请求。常见做法是记录当前请求标识,或在支持取消的环境里使用 AbortController,只允许最新的一次意图提交状态。
如何验收这条链路
验收时不要只看“最后是否到了房间页”,还要检查中间状态是否正确。点击后应立即进入 pending;成功响应到达后才能写入成员和队长信息;状态提交完成后才导航;失败时仍留在大厅,并重新允许用户操作。
一个可靠的进房链路,本质上是在控制副作用顺序:界面负责意图,API 负责通信,store 负责权威客户端状态,路由负责呈现。把这四层顺序固定后,后续加入退房、准备和开局事件时也能沿用同一模型。