多人游戏与网络同步 / 系统课时
什么时候应该停止自动重连
什么时候应该停止自动重连
自动重连不是“只要失败就继续试”。真正可控的策略必须区分临时网络故障与已经不可能自行恢复的业务状态,并给重试次数、离线时长和服务器拒绝设置明确上限,最终把客户端带到可解释、可操作的终止状态。
学习目标
- 区分可继续重试的瞬时故障与必须停止的终止条件
- 为认证、版本、房间状态和持续离线设计确定的退出路径
- 用统一决策函数验证重连策略不会陷入无限循环
先把失败分成可恢复与不可恢复
一次连接失败只说明“这次没有恢复成功”,不等于下一次还值得尝试。客户端收到失败后,应先判断失败原因,再决定是重试、暂停还是终止。
适合继续自动重连的通常是短暂超时、连接重置、网络瞬断、DNS 临时失败等传输层问题。它们的共同点是:会话仍可能有效,服务器也没有明确拒绝恢复。
以下情况则应立即停止自动重连:
- 认证凭据失效或被撤销:继续使用同一凭据只会重复得到拒绝,应转到重新登录。
- 客户端版本不兼容:必须升级后才能进入服务器,重试网络没有意义。
- 房间关闭、比赛结束或席位已释放:目标会话已经不存在,应回到大厅或结果页。
- 服务器明确返回不可恢复的会话错误:例如恢复令牌无效、角色已被踢出或会话被替换。
还有一类是“暂时没有硬错误,但已经离线太久”。这时应停止当前自动循环,保留“手动重试”或“等待网络恢复后再试”的入口,避免后台持续耗电和制造无效请求。
用决策顺序避免误判
重连终止逻辑最好集中在一个决策点,而不是散落在连接回调、登录逻辑和 UI 中。判断顺序应先看服务器给出的确定性拒绝,再看本地策略上限,最后才决定是否继续退避重试。

这套顺序有两个好处:认证失效不会因为“还有重试次数”而继续请求;持续离线也不会被误判为永久会话失败。前者需要用户或版本动作,后者只是停止自动循环。
把策略写成可验证的决策函数
下面的 Node.js 示例只负责“下一步做什么”,不负责真正建立网络连接。把策略做成纯函数后,可以用固定输入覆盖所有终止分支,避免在异步回调里遗漏条件。
const TERMINAL_ACTIONS = {
AUTH_INVALID: "STOP_AND_LOGIN",
VERSION_UNSUPPORTED: "STOP_AND_UPDATE",
ROOM_CLOSED: "STOP_AND_RETURN_TO_LOBBY",
MATCH_FINISHED: "STOP_AND_RETURN_TO_RESULTS",
};
function decideReconnect({
reason,
networkOnline,
offlineMs,
attempts,
maxOfflineMs = 120_000,
maxAttempts = 5,
}) {
if (TERMINAL_ACTIONS[reason]) {
return TERMINAL_ACTIONS[reason];
}
if (!networkOnline) {
return offlineMs >= maxOfflineMs
? "STOP_AUTO_AND_SHOW_MANUAL_RETRY"
: "PAUSE_UNTIL_NETWORK_CHANGE";
}
if (attempts >= maxAttempts) {
return "STOP_AUTO_AND_SHOW_MANUAL_RETRY";
}
return "BACKOFF_AND_RETRY";
}
const cases = [
{ reason: "AUTH_INVALID", networkOnline: true, offlineMs: 0, attempts: 1 },
{ reason: "TIMEOUT", networkOnline: false, offlineMs: 30_000, attempts: 2 },
{ reason: "TIMEOUT", networkOnline: false, offlineMs: 130_000, attempts: 2 },
{ reason: "TIMEOUT", networkOnline: true, offlineMs: 0, attempts: 5 },
{ reason: "TIMEOUT", networkOnline: true, offlineMs: 0, attempts: 2 },
];
for (const item of cases) {
console.log(decideReconnect(item));
}预期输出:
STOP_AND_LOGIN
PAUSE_UNTIL_NETWORK_CHANGE
STOP_AUTO_AND_SHOW_MANUAL_RETRY
STOP_AUTO_AND_SHOW_MANUAL_RETRY
BACKOFF_AND_RETRY实际项目中,maxOfflineMs 和 maxAttempts 应来自同一份重连策略配置,并由产品场景决定;例如实时对战通常比异步房间更早放弃恢复。
停止之后必须进入明确状态
“停止自动重连”不能只是停止定时器。客户端还要撤销下一次重试任务、关闭仍在握手的连接、清理重连中的 UI 状态,并把原因映射到一个稳定去向。
认证失效应进入重新认证;版本不兼容应阻止继续进入游戏并提示更新;房间关闭应返回大厅或结果页;达到重试或离线时长上限时,可以保留手动重试,但不要自动重新启动循环。
终止条件的核心不是“失败了几次”,而是判断下一次自动尝试是否还有新的成功条件。没有新条件就停止;条件可能随网络恢复而改变时就暂停并等待事件,而不是盲目轮询。