应复用http.Client实例,全局单例配置Transport连接池参数,禁用HTTP/2以规避兼容问题,显式设置Timeout、IdleConnTimeout等超时避免goroutine泄漏,禁止修改http.DefaultTransport。

复用 http.Client 实例,避免每次请求都新建
Go 中 http.Client 是并发安全的,且内部维护连接池(http.Transport),频繁创建新实例会导致 TCP 连接无法复用、TLS 握手重复、内存分配增加。默认的 http.DefaultClient 已配置合理,但自定义时需注意。
- 不要在 handler 或高频函数里写
client := &http.Client{} - 若需定制,应全局复用单个实例,例如:
var httpClient = &http.Client{ Transport: &http.Transport{ MaxIdleConns: 100, MaxIdleConnsPerHost: 100, IdleConnTimeout: 30 * time.Second, }, } - 设置
MaxIdleConnsPerHost至少等于预期并发请求数,否则连接池会主动关闭空闲连接,退化为短连接
禁用 HTTP/2(某些代理或服务端不兼容时)
Go 1.6+ 默认启用 HTTP/2,但在对接老旧网关、Nginx(未配 http2)、或中间件(如某些企业级 API 网关)时,可能触发 http: server closed idle connection 或 TLS 协商失败。这不是性能问题,而是稳定性问题,间接导致重试和延迟升高。
- 临时禁用方式:设置环境变量
GODEBUG=http2server=0(仅影响服务端)或客户端侧强制降级 - 更可控的做法是在
http.Transport中禁用:Transport: &http.Transport{ ForceAttemptHTTP2: false, // 其他配置... } - 注意:禁用后仍走 HTTP/1.1,但可规避握手异常、流控不一致等隐性超时
设置合理的超时,防止 goroutine 泄漏
未设超时的 http.Client 在网络抖动或服务不可达时会无限等待,堆积 goroutine,最终耗尽资源。Go 的 net/http 不提供“总超时”,必须组合使用多个字段。
- 必须显式设置:
Timeout(从发起到响应头读完)、IdleConnTimeout(空闲连接存活时间)、TLSHandshakeTimeout(TLS 握手上限) - 常见误配:
Timeout设为 5s,但没设KeepAlive和IdleConnTimeout,导致连接池中大量 stale 连接无法回收 - 推荐组合:
Timeout: 10 * time.Second, Transport: &http.Transport{ DialContext: (&net.Dialer{ Timeout: 5 * time.Second, KeepAlive: 30 * time.Second, }).DialContext, TLSHandshakeTimeout: 5 * time.Second, IdleConnTimeout: 30 * time.Second, // ... }
慎用 http.DefaultTransport 的全局副作用
http.DefaultTransport 是包级变量,任何依赖库(比如第三方 SDK、监控埋点 client)修改它,都会影响你自己的请求行为——比如某个库悄悄把 MaxIdleConns 改成 5,你的高并发请求立刻变慢。
立即学习“go语言免费学习笔记(深入)”;
- 永远不要直接修改
http.DefaultTransport字段 - 所有自定义 client 都应构造独立的
http.Transport实例 - 若必须共享配置,用函数封装初始化逻辑,而非复用默认 transport:
func newTransport() *http.Transport { return &http.Transport{ MaxIdleConns: 200, MaxIdleConnsPerHost: 200, // ... } }
连接池参数调得再高也没用,如果 transport 被其他代码污染了,或者没做并发隔离,性能优化就只是幻觉。











