Gin 默认不处理移动网络重试，因为它仅是服务端HTTP路由框架，不感知或干预客户端请求发起过程；重试必须由开发者在handler内调用第三方API时，基于独立context显式实现，针对弱网优化超时、退避和错误类型。
为什么 Gin 默认不处理移动网络重试
Gin 本身只是 HTTP 路由框架，gin.Context 不封装重试逻辑，也不干预 http.Client 行为。它只负责接收已建立的连接、解析请求、分发 handler。移动网络下的高延迟（如弱信号、NAT 超时、运营商 DNS 缓慢）导致的请求失败，发生在客户端发起请求阶段，Gin 完全感知不到——它只看到“已经连上来的请求”。所以指望 gin.Default() 或中间件自动重试 HTTP 请求，是方向错误。
真正要重试的是客户端调用方，不是 Gin 服务端
你在 Gin 里写的 c.JSON(200, data) 是响应，不是发起请求；需要重试的，是你在 Gin handler 里主动调用第三方 API 的那部分代码，比如：http.DefaultClient.Do(req) 或 resty.New().R().Get(url)。这时候重试必须由你显式控制：
- 不能把重试逻辑塞进 Gin 中间件（除非你写的是反向代理类中间件，且明确 wrap 了 outbound 请求）
- 每个 outbound 调用点都应独立配置重试策略：不同 API 的幂等性、超时容忍度、错误码语义都不同
- 若用
github.com/go-resty/resty/v2，直接用.SetRetryCount(3).SetRetryWaitTime(100*time.Millisecond)；若用原生http.Client，需自己实现或引入github.com/cenkalti/backoff/v4 - 务必搭配
context.WithTimeout，否则指数退避可能让总耗时远超移动端用户耐心（建议整体上限 ≤ 8s）
移动网络下必须调整的三个关键参数
标准重试策略在 Wi-Fi 下可行，在 4G/5G 边缘区域会失效。实测表明，以下三处不调，重试反而增加失败率：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
DialContext超时必须设为 ≤ 3s：运营商 DNS 解析常卡在 5–10s，net.Dialer{Timeout: 3*time.Second}可快速失败并触发重试，避免单次阻塞拖垮整个退避节奏 - 首次退避间隔从 100ms 起步，而非 1s：
backoff.WithInitialInterval(100 * time.Millisecond)，移动网络抖动恢复快，长延迟只会让用户多等 - 只重试明确的瞬态错误：
net.OpError（含"i/o timeout"、"connection refused"）、context.DeadlineExceeded，但绝不重试401、403、422等业务错误——它们和网络无关，重试无意义
别碰 Gin 的 context，用你自己的 ctx 控制重试
gin.Context 的生命周期绑定于单次 HTTP 请求，它自带的 c.Request.Context() 仅用于 cancel 当前响应流，**不能**用于控制 outbound 请求的重试超时。你必须创建独立的 context.Context：
立即学习“go语言免费学习笔记（深入）”；
- 用
ctx, cancel := context.WithTimeout(context.Background(), 6*time.Second)，而非c.Request.Context() - 重试循环中每次
http.NewRequestWithContext(ctx, ...)，确保 transport 层能响应 cancel - 每次重试前检查
if ctx.Err() != nil { return err }，避免在 deadline 已到后还 sleep 或发请求 - 如果 Gin handler 本身设置了
c.Request.Context()超时（如 Nginx proxy_read_timeout = 10s），你的 outbound 重试总耗时必须严格小于它，否则 Gin 会提前关闭连接，返回504 Gateway Timeout
移动网络重试最易被忽略的点：不是“要不要重试”，而是“重试时是否还在用旧的 DNS 缓存、过期的 TLS session ticket、或已被中间设备回收的 TCP 连接”。每次重试必须重建完整连接链路，而不是复用 client.Transport 的 idle conn——这在弱网下反而加剧失败。
