多人游戏与网络同步 / 系统课时
创建房间失败后状态怎么复原
创建房间失败后状态怎么复原
创建房间失败时,最危险的不是弹出错误,而是客户端停留在半创建状态。本节把网络失败、业务拒绝和超时分开处理,并规定每种结果该回到哪个状态、保留哪些输入,让用户可以安全重试而不会丢失上下文。
学习目标
- 区分网络失败、业务拒绝和超时三类创建失败
- 为每类失败定义明确的状态回退与用户可见反馈
- 用
finally与请求标识保证 loading 状态一定被清理
先定义可恢复的创建状态
创建房间通常从 editing 开始,提交后进入 creating。只有服务端确认成功才进入 inRoom;网络错误、业务拒绝或超时都应结束 creating,但它们的提示和重试策略不同。

失败后的默认回退状态应是 editing,这样房间名、模式和人数等输入仍可修改或重试。不要失败后直接清空表单,也不要把 creating 当成“直到成功为止”的永久状态。
三类失败可以这样理解:
| 失败类型 | 客户端知道什么 | 推荐动作 |
|---|---|---|
| 网络失败 | 请求没有得到可用响应 | 回到 editing,允许重试 |
| 业务拒绝 | 服务端明确拒绝创建 | 回到 editing,展示拒绝原因 |
| 超时 | 客户端在期限内没拿到结果 | 回到 editing,但提示结果可能未知 |
超时最特殊:客户端不知道服务端是否已经创建成功。如果创建接口不是幂等的,立即无脑重试可能生成两个房间,因此超时后的提示应与普通网络失败区分。
把失败分类写进请求边界
下面示例使用 Node.js 运行,模拟四种创建结果。业务拒绝由服务端结构化结果表示;网络失败抛出普通错误;超时由客户端定时器转成专门的 TimeoutError。
class TimeoutError extends Error {}
const state = {
phase: "editing",
activeRequestId: 0,
error: null
};
function fakeCreateRoom(mode) {
return new Promise((resolve, reject) => {
if (mode === "network") {
setTimeout(() => reject(new Error("connection lost")), 30);
return;
}
if (mode === "business") {
setTimeout(() => resolve({ ok: false, code: "NAME_TAKEN" }), 30);
return;
}
const delay = mode === "timeout" ? 200 : 30;
setTimeout(() => resolve({ ok: true, roomId: "room-88" }), delay);
});
}
function withTimeout(promise, ms) {
return Promise.race([
promise,
new Promise((_, reject) =>
setTimeout(() => reject(new TimeoutError("create room timed out")), ms)
)
]);
}
async function createRoom(mode) {
const requestId = ++state.activeRequestId;
state.phase = "creating";
state.error = null;
try {
const result = await withTimeout(fakeCreateRoom(mode), 80);
if (requestId !== state.activeRequestId) return;
if (!result.ok) {
state.phase = "editing";
state.error = `business:${result.code}`;
return;
}
state.phase = "inRoom";
console.log(`success:${result.roomId}`);
} catch (error) {
if (requestId !== state.activeRequestId) return;
state.phase = "editing";
state.error =
error instanceof TimeoutError
? "timeout:result-unknown"
: `network:${error.message}`;
} finally {
if (requestId === state.activeRequestId) {
console.log(`${mode} -> phase=${state.phase}, error=${state.error}`);
}
}
}
(async () => {
await createRoom("network");
await createRoom("business");
await createRoom("timeout");
await createRoom("success");
})();预期输出
network -> phase=editing, error=network:connection lost
business -> phase=editing, error=business:NAME_TAKEN
timeout -> phase=editing, error=timeout:result-unknown
success:room-88
success -> phase=inRoom, error=null动态网络环境中的错误文本可能不同,但状态原则不变:只有确认成功才能进入 inRoom,所有失败都必须结束 creating。
失败时保留哪些状态
回退不是把整个 store 重置。创建失败后应保留用户仍然需要的信息,例如房间名、地区、玩法和人数上限;应清除的通常只有本次请求相关状态,如 loading、当前错误和一次性请求标识。
业务拒绝还可以把服务端错误映射到具体字段。例如 NAME_TAKEN 应提示修改房间名,而不是只显示“创建失败”。网络失败则不应误导用户去修改合法表单。
超时需要额外谨慎。若服务端支持客户端生成的幂等键,可以用同一个键安全重试;如果没有幂等保证,更稳妥的是先刷新自己创建的房间或查询创建结果,再决定是否重试。
用单一出口清理进行中状态
实际代码最容易漏的是异常路径:成功分支关闭 loading,业务错误也关闭了,但网络异常直接 throw 后按钮一直禁用。把“请求结束后的 UI 清理”放在 finally 或统一状态转换函数里,可以减少这种遗漏。
创建失败后的正确目标不是“恢复成提交前完全一样”,而是恢复到一个可继续操作、且不会掩盖不确定性的状态。把失败类型、回退状态和重试策略绑定在一起,客户端才能在异常网络下仍保持可预测。