直接改http.DefaultTransport很危险，因其被http.DefaultClient及所有未显式指定Transport的客户端共享，会导致第三方库（如OpenTelemetry、Prometheus）的健康检查等请求也被意外影响，正确做法是为业务单独创建带自定义RoundTripper的http.Client以实现隔离。
为什么直接改 http.DefaultTransport 很危险
很多新手一上来就对 http.DefaultTransport 做赋值或字段修改，比如加 Timeout、换 DialContext，结果发现全局所有 HTTP 请求都受影响——包括第三方库发起的请求（如 go.opentelemetry.io/otel 的健康检查、prometheus/client_golang 的指标上报）。这不是 bug，是设计使然：http.DefaultClient 和所有未显式指定 Transport 的 http.Client 都共享它。
真正安全的做法是：为特定业务逻辑创建独立的 http.Client，并绑定自定义 RoundTripper。这样既隔离影响，又便于测试和监控。
实现一个带重试和日志的 RoundTripper
标准 http.Transport 本身不支持重试，而重试逻辑若放在业务层（比如 for 循环调用 client.Do），会丢失底层连接复用、HTTP/2 流控等优势。正确位置是在 RoundTrip 方法里拦截失败响应。
关键点：
立即学习“go语言免费学习笔记（深入）”；
-
RoundTrip必须是线程安全的，不能在结构体里存非原子状态（如计数器） - 不要在
RoundTrip内部修改传入的*http.Request（比如重写URL或Header），除非你 clone 了它——原请求可能被复用或并发使用 - 超时应由外层
context.WithTimeout控制，RoundTripper只负责执行，不负责设 timeout
示例骨架：
type LoggingRetryTransport struct {
base http.RoundTripper
maxRetries int
}
<p>func (t <em>LoggingRetryTransport) RoundTrip(req </em>http.Request) (<em>http.Response, error) {
var err error
var resp </em>http.Response</p><pre class="brush:php;toolbar:false;">for i := 0; i <= t.maxRetries; i++ {
// 注意：每次重试必须 clone request，避免 Header 被污染
reqCopy := req.Clone(req.Context())
resp, err = t.base.RoundTrip(reqCopy)
if err == nil && resp.StatusCode < 500 {
return resp, nil
}
if i < t.maxRetries {
time.Sleep(time.Second * time.Duration(1<<i)) // 指数退避
}
}
return resp, err}
http.Transport 的哪些字段该配、哪些不该动
自定义 RoundTripper 通常包装一个配置好的 http.Transport，但不是所有字段都适合调整：
- ✅ 推荐配：
MaxIdleConns、MaxIdleConnsPerHost、IdleConnTimeout、TLSClientConfig（比如跳过证书校验仅限测试） - ⚠️ 少动：
DialContext—— 若需自定义 DNS 或代理，优先用http.ProxyFromEnvironment或http.Transport.Proxy；自己写DialContext容易漏掉KeepAlive、Timeout等底层控制 - ❌ 别碰：
CloseIdleConnections是方法，不是字段；调用它会强制关闭所有空闲连接，不应在RoundTrip中触发
一个常见错误是把 http.Transport 当成“一次配置永久生效”的对象，其实它的字段在运行时可变，但并发修改（比如多个 goroutine 同时改 MaxIdleConns）会导致 panic。初始化后就别再改。
如何测试自定义 RoundTripper 是否生效
光看请求发出去了不够，得确认你的逻辑真被调用了。最直接的办法是加一行 log.Printf 在 RoundTrip 开头，但生产环境不能留日志。更可靠的是用接口 mock：
- 写一个
mockRT实现RoundTripper，内部用sync.Mutex+ 计数器记录调用次数 - 在测试中把
mockRT包进你的自定义 transport，然后发请求，断言计数器是否符合预期（比如失败两次后第三次成功 → 调用 3 次） - 注意：测试时别用
http.ListenAndServe起真实 server，用httptest.NewUnstartedServer或直接构造*http.Response返回，避免依赖网络
容易忽略的一点：Go 的 http.Transport 默认启用 HTTP/2，如果你的自定义 RoundTripper 不转发 Request.ProtoMajor 或篡改 Transfer-Encoding，可能导致 http2: invalid upgrade response 错误——这种问题只在 HTTPS 场景下暴露，本地 HTTP 测试根本测不出来。
