context.withtimeout是唯一能真正中断三方api调用的机制，因其可穿透dns解析、tcp连接、tls握手等各阶段；其他方式如仅设http.client.timeout无法生效，因超时依赖显式传入并透传context，且transport层需配置dialcontext等参数。
context.WithTimeout 是唯一能真正中断三方 API 调用的机制，其他方式（比如只设 http.Client.Timeout）根本拦不住 DNS 卡住、TCP 连接 hang 死或 TLS 握手卡顿。
HTTP 请求必须显式传入 context，否则超时形同虚设
很多人写了 client.Timeout = 5 * time.Second 就以为稳了，结果日志里全是 net/http: request canceled，或者客户端等了 20 秒才返回 —— 说明超时压根没生效。
根本原因是：http.Client.Timeout 只在 req.WithContext(ctx) 被调用时才起作用。如果你手动构造 *http.Request 后直接调用 client.Do(req)，而没写成 client.Do(req.WithContext(ctx))，那这个 ctx 就完全没传递下去。
- 必须用
http.NewRequestWithContext(ctx, method, url, body)构造请求 - 如果封装了 SDK（比如云厂商 Go SDK），要确认它是否透传
ctx；不少 SDK 内部会忽略你传的ctx，得翻源码或查文档 - 别复用未配置 timeout 的全局
http.DefaultClient，一个慢请求就能拖垮整条链路
Transport 层不配 DialContext，超时在连接阶段就失效
即使 req.WithContext(ctx) 写对了，如果 http.Transport 没配好，DNS 解析、SYN 重试、TLS 握手这些底层阻塞阶段照样绕过 ctx。
-
DialContext必须用&net.Dialer{Timeout: 3 * time.Second}初始化，否则连接建立阶段不响应 cancel -
ResponseHeaderTimeout控制从发完请求到收到响应头的时间，防 header 卡死 -
TLSHandshakeTimeout和ExpectContinueTimeout也建议显式设，尤其调用 HTTPS 服务时
重试不是“err != nil 就 retry”，得精准过滤错误类型
盲目重试等于放大故障。400 错误、codes.InvalidArgument、sql.ErrNoRows 这类确定性错误，重试只会重复失败，还加重下游压力。
- HTTP 场景：只对
resp.StatusCode >= 500或网络错误（如net.OpError、url.Error.Timeout()返回 true）重试；4xx 一律跳过 - gRPC 场景：用
status.Code(err)判断，只重试codes.Unavailable、codes.ResourceExhausted；codes.NotFound或codes.DeadlineExceeded不该进重试循环 - 别用
strings.Contains(err.Error(), "timeout")做判断 —— 错误信息可能本地化、服务端变更，且覆盖不了net/http.ErrHandlerTimeout - 封装统一函数
shouldRetry(err error) bool收口逻辑，避免散落在各处
retry-go / backoff.v4 的坑：不绑 context、不 reset、不加 jitter 就等于埋雷
裸用 retry.Do 或 backoff.Retry 是错的 —— 它们完全不感知 context.Context 取消。哪怕外层 ctx 已被 cancel，重试仍会跑完全部次数，最终卡死 goroutine。
- 必须用
backoff.WithContext(b, ctx)包装，让每次NextBackOff()都检查上下文状态 - 每个请求应独立初始化退避实例，或复用时严格调用
b.Reset()；共享实例会导致 attempt 计数器串号、间隔错乱 - 抖动（jitter）不是可选项：纯 2^n 退避在高并发下会形成脉冲流量，推荐延迟公式为
base * math.Pow(2, float64(attempt)) * (0.5 + rand.Float64()*0.5) -
retry.Attempts(3)表示总共执行 3 次（含首次），即最多重试 2 次；若想重试 3 次，得写retry.Attempts(4)
最常被忽略的是：每次重试前都必须新建 context.WithTimeout 实例，而不是复用同一个。重试逻辑里的 time.Sleep 或退避等待，也必须受 select { case 约束，否则就是 goroutine 泄漏温床。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
