Vue 3中可构建可配置、有节制、带退避的智能重试策略:结合网络错误码、响应耗时、Network Information API识别弱网;在响应拦截器error回调中,基于retryCount、指数退避、请求幂等性等条件执行重试,并协同用户体验提示。

Vue 3 中请求拦截器本身不直接感知弱网,但可以结合网络状态、错误类型、响应耗时和业务优先级,构建一套**可配置、有节制、带退避的智能重试策略**。关键不是“一概重试”,而是“该重试的才重试,且重试得聪明”。
识别弱网信号:不止靠 navigator.onLine
单纯判断 navigator.onLine 不可靠(Wi-Fi 断开但本地代理仍通,或 4G 信号满格但实际丢包严重)。建议组合使用:
-
请求超时 + 网络错误码:如
ERR_NETWORK、ERR_CONNECTION_TIMED_OUT、ERR_FAILED,这些是弱网/断网最直接的表现; - 响应耗时阈值:在请求拦截器中记录开始时间,在响应拦截器中计算耗时;若超过预设弱网阈值(如 8s),标记本次请求为“疑似弱网”;
-
Network Information API(可选增强):通过
navigator.connection?.effectiveType获取'2g'、'3g'、'slow-2g'等值,作为重试策略的上下文参考(注意兼容性,需降级处理)。
重试逻辑嵌入响应拦截器
重试动作必须放在 响应拦截器的 error 回调 中,因为只有此时才能明确知道请求失败原因。核心思路是:检查是否允许重试 → 判断是否符合弱网重试条件 → 执行带延迟的递归重试。
- 在请求 config 上扩展字段,如
retryCount: 2、retryOnWeakNet: true、retryDelay: 1000(首次延迟); - 在响应 error 处理中,仅对特定错误(如网络类错误、502/503/504 网关错误)且剩余重试次数 > 0 时触发重试;
- 采用指数退避(exponential backoff):第 n 次重试延迟 =
baseDelay × 2^(n-1),避免雪崩式重试; - 重试前克隆原始 config(避免 signal 被取消、headers 被污染),并更新
retryCount和__retryTimes计数器。
避免无效重试:设置明确的“不可重试”边界
不是所有失败都适合重试。应在重试前快速过滤掉以下情况:
立即学习“前端免费学习笔记(深入)”;
- 4xx 客户端错误(除 408 Request Timeout 外):如 400、401、403、404,重试无意义,应交由业务逻辑或全局错误处理器处理;
-
主动取消请求(
error.code === 'ERR_CANCELED'):用户已退出页面或切换 tab,不应再重试; - 非 GET/HEAD 请求:POST/PUT/DELETE 等非幂等操作默认不重试(除非业务明确要求且后端支持幂等 ID);
- 已重试超过上限 或 当前处于离线状态且无缓存兜底能力时,直接 reject。
用户体验协同:重试 ≠ 静默等待
真正的“智能”体现在用户侧反馈:
- 首次请求失败后,若判定为弱网且将重试,可短暂显示轻量提示:“网络较慢,正在重试…”(非弹窗,避免打断);
- 重试失败后,统一走错误提示流程,并提供“手动重试”按钮(绑定到原始请求函数,而非简单刷新);
- 对核心请求(如登录、支付)可适当提高重试次数与容忍延迟;对非核心请求(如推荐列表)可降低重试权重甚至跳过重试。


















