异步重试机制需满足三原则:只重试可恢复错误(如5xx、网络异常)、采用带抖动的指数退避错开时间、设次数与总耗时双上限,并辅以可观测性与用户反馈。
异步重试机制不是“多试几次”那么简单,而是要在失败时做对三件事:只重试可恢复的错误、错开重试时间避免雪崩、控制总耗时防止拖垮整个流程。核心是策略性等待,而不是盲目轮询。
只对可重试错误触发重试
不是所有错误都适合重试。400、401、404 这类客户端错误说明请求本身有问题,重试毫无意义;而 502、503、504、超时、连接中断、DNS 失败等属于服务端临时异常,才值得重试。
- HTTP 请求中,建议仅对 5xx 状态码、网络异常(如 AbortError、TypeError)、超时异常 启动重试
- 在 Python 的
requests+urllib3.Retry中,用status_forcelist=[502, 503, 504]显式指定 - 在 JavaScript 的 fetch 封装中,需手动检查
response.status和err.name(如'TypeError'表示网络断开)
采用指数退避(Exponential Backoff)延迟
固定间隔重试(如每次等 1 秒)容易引发“惊群效应”——大量客户端在同一时刻重发请求,反而压垮本就脆弱的服务。
- 推荐使用指数退避:第 1 次失败后等 0.5 秒,第 2 次等 1 秒,第 3 次等 2 秒,第 4 次等 4 秒……公式为
base_delay × 2^attempt - 可加入随机抖动(jitter),例如乘以
0.5–1.5的随机因子,进一步打散重试时间点 - Python 的
stamina库默认启用指数退避;JavaScript 可用setTimeout(r, base * Math.pow(2, i) * Math.random() * 1.5)实现
设定硬性边界:次数上限与总超时
无限重试会延长用户等待、占用资源、掩盖真实问题。必须设两个兜底限制:
- 最大重试次数:通常 3~5 次足够覆盖大多数瞬时故障;超过即放弃,交由上层降级或报错
- 总超时时间:例如设置“最多尝试 30 秒”,哪怕还没到最大次数,超时即终止——这对用户感知和系统响应至关重要
- 像
stamina.retry(timeout=30.0, attempts=5)或httpx.AsyncClient(timeout=30.0)都支持这种组合约束
配合可观测性与用户反馈
重试过程不能黑盒运行。生产环境需让重试“可看见、可追踪、可干预”:
- 每次重试前记录日志,包含 URL、错误类型、当前重试序号、下次等待时长
- 前端请求中,在 loading 状态显示“正在重试 (2/3)”降低用户焦虑
- 提供手动重试入口(如按钮),并确保该操作复用同一套重试逻辑,不绕过退避策略
- 结合
navigator.onLine或预检请求(如轻量 HEAD 请求),离线时直接跳过自动重试,避免无效等待










