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

创建房间失败后状态怎么复原

创建房间失败后状态怎么复原

创建房间失败时,最危险的不是弹出错误,而是客户端停留在半创建状态。本节把网络失败、业务拒绝和超时分开处理,并规定每种结果该回到哪个状态、保留哪些输入,让用户可以安全重试而不会丢失上下文。

学习目标

  • 区分网络失败、业务拒绝和超时三类创建失败
  • 为每类失败定义明确的状态回退与用户可见反馈
  • 用 finally 与请求标识保证 loading 状态一定被清理

先定义可恢复的创建状态

创建房间通常从 editing 开始,提交后进入 creating。只有服务端确认成功才进入 inRoom;网络错误、业务拒绝或超时都应结束 creating,但它们的提示和重试策略不同。

创建房间失败后的状态恢复流程

失败后的默认回退状态应是 editing,这样房间名、模式和人数等输入仍可修改或重试。不要失败后直接清空表单,也不要把 creating 当成“直到成功为止”的永久状态。

三类失败可以这样理解:

失败类型 客户端知道什么 推荐动作
网络失败 请求没有得到可用响应 回到 editing,允许重试
业务拒绝 服务端明确拒绝创建 回到 editing,展示拒绝原因
超时 客户端在期限内没拿到结果 回到 editing,但提示结果可能未知

超时最特殊:客户端不知道服务端是否已经创建成功。如果创建接口不是幂等的,立即无脑重试可能生成两个房间,因此超时后的提示应与普通网络失败区分。

把失败分类写进请求边界

下面示例使用 Node.js 运行,模拟四种创建结果。业务拒绝由服务端结构化结果表示;网络失败抛出普通错误;超时由客户端定时器转成专门的 TimeoutError。

js
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");
})();

预期输出

text
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 或统一状态转换函数里,可以减少这种遗漏。

创建失败后的正确目标不是“恢复成提交前完全一样”,而是恢复到一个可继续操作、且不会掩盖不确定性的状态。把失败类型、回退状态和重试策略绑定在一起,客户端才能在异常网络下仍保持可预测。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建房间失败后状态怎么复原

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

登录哪都通