外部API调用慢的根源在于超时分层缺失、重试逻辑失控、连接池配置失当及JSON解析与context透传开销；需分层设置HTTP客户端超时、按幂等性与错误码语义定制重试、依目标服务特征调优连接池、限制响应体大小并避免context滥用。
外部API调用慢，不是加个 go 就能解决的。真正拖慢微服务响应的，往往是超时设置不合理、重试逻辑失控、连接复用被破坏，以及 JSON 解析和上下文传递这些“看不见”的开销。
HTTP客户端超时必须分层设置
只设一个 Timeout 是最常见错误。它会同时约束连接建立、TLS握手、首字节到达和整个响应读取，导致本可快速失败的请求卡满 30 秒。
-
Timeout应设为整体兜底（如10s），仅用于防雪崩 -
Transport.DialContextTimeout控制建连（建议2s） -
Transport.TLSHandshakeTimeout单独设（3s，尤其对接老系统时） -
Transport.ResponseHeaderTimeout约束 header 到达（5s，避免后端挂住不发 header） -
Transport.ExpectContinueTimeout若用100-continue，需显式设（1s）
没分层，你就等于把 DNS 查询失败、证书过期、网关丢包全当成“业务慢”，根本没法定位。
重试不能无脑用 retryablehttp
直接套用通用重试库，大概率让下游更堵。外部 API 的幂等性、限流策略、错误码语义，你得自己对齐。
立即学习“go语言免费学习笔记（深入）”；
- 429 和 503 必须重试，但要带指数退避 + jitter；500 不一定重试，得看对方文档是否承诺幂等
- 重试前检查
req.Context.Err()，避免超时后还在发请求 - 别重试含 body 的 POST/PUT，除非确认接口支持幂等（比如带
Idempotency-Key） - 记录每次重试的
http.Request.URL和http.Response.StatusCode，否则出问题只能抓瞎
某支付回调服务曾因盲目重试 400 错误，触发下游风控规则，导致批量拒单。
连接池参数不匹配外部API特征就是负优化
MaxIdleConns 和 MaxIdleConnsPerHost 设太高，会撑爆对方连接数限制；设太低，又频繁重建 TLS 连接。
- 先查目标 API 的
Connection: keep-alive响应头和Keep-Alive: timeout=值（如有） - 若对方是云厂商 API（如 AWS/Aliyun），默认 keep-alive 超时多为
60–300s，MaxIdleConnsPerHost设20–50较稳 - 若对接的是 PHP 或老旧 Java 服务，keep-alive 往往不可靠，
MaxIdleConnsPerHost降到2–5反而更省资源 - 务必禁用
Transport.IdleConnTimeout自动关闭（设为 0），由对方决定连接生命周期
曾有个对接政务系统的微服务，对方 nginx 配置了 keepalive_timeout 5s，但我们设了 IdleConnTimeout: 30s，结果连接池里一堆 stale conn，大量请求 fallback 到新建连接。
JSON 解析和 context 透传容易成隐性瓶颈
标准 encoding/json 解析大响应体时，GC 压力和反射开销会明显拖慢 goroutine 执行；而透传 context.Context 时若混用 context.WithValue 存大量结构体，会放大逃逸和内存分配。
- 对外部 API 响应体大小做硬限制（如用
io.LimitReader(resp.Body, 2），防 OOM - 用
jsoniter.ConfigCompatibleWithStandardLibrary替代原生 json，无需改代码，解析快 1.7 倍左右 - context 里只存必要元数据（如 traceID、userIP），别塞
*http.Request或完整 payload - 如果外部 API 支持
Accept: application/json+stream，优先用jsoniter.NewDecoder流式解码，减少中间 buffer
最易被忽略的是：你优化了自己服务的 CPU 和 GC，但外部 API 返回的 5MB JSON 仍要被完整 decode → marshal → 再 encode 给前端，这一来一回的序列化成本，可能占端到端耗时 40% 以上。
