应配置 http.Transport 复用连接:设 MaxIdleConns 与 MaxIdleConnsPerHost ≥100,IdleConnTimeout 为 30–90 秒,合理设置 TLSHandshakeTimeout 和 ResponseHeaderTimeout;优先用 json.Decoder 流式解析小 JSON 响应。

用 http.Transport 复用连接,避免每次请求都建连
默认的 http.DefaultClient 使用的 http.Transport 没有调优,会导致大量 TIME_WAIT、DNS 重查、TLS 握手开销。关键不是换库,而是配置好底层 Transport。
-
MaxIdleConns和MaxIdleConnsPerHost必须显式设为大于 0 的值(如 100),否则默认是 2,连接池形同虚设 -
IdleConnTimeout建议设为 30–90 秒,太短导致频繁重连,太长可能占住后端连接不释放 -
TLSHandshakeTimeout和ResponseHeaderTimeout要设合理上限,防止慢后端拖垮整个 client - 若对接同一域名的多个子服务,
MaxIdleConnsPerHost比MaxIdleConns更关键——它按 Host 隔离连接池
tr := &http.Transport{
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
IdleConnTimeout: 60 * time.Second,
TLSHandshakeTimeout: 5 * time.Second,
ResponseHeaderTimeout: 10 * time.Second,
}
client := &http.Client{Transport: tr}慎用 context.WithTimeout,别让超时逻辑反拖慢正常请求
在 handler 中对每个下游 HTTP 请求套一层 context.WithTimeout 很常见,但容易忽略两点:一是 timeout 是从调用时刻开始计,不是从真正发包开始;二是如果上游已超时,再起 goroutine 发请求只是白耗资源。
- 不要在中间件或公共封装里统一加固定 timeout,应按下游服务 SLA 分级设置(比如配置中心 200ms,日志上报 5s)
- 用
context.WithDeadline替代WithTimeout,把剩余超时时间精确传递,避免嵌套误差 - 如果 handler 自身 context 已被 cancel(如客户端断开),
http.Do会立即返回context.Canceled,无需额外判断
JSON 解析别总用 json.Unmarshal,小数据用 json.Decoder 更稳
当处理大量小响应体(如 API 返回 1KB 内 JSON)时,json.Unmarshal([]byte) 看似简单,实则隐含两次内存拷贝:一次读 body 到字节切片,一次解析时内部再 copy。而 json.Decoder 可直接流式解析 io.ReadCloser。
- 尤其在高并发下,避免频繁分配小对象,
json.Decoder复用实例还能减少 GC 压力 - 注意
Decoder不是完全线程安全的,需 per-request 新建或加锁复用 - 如果响应体可能含 BOM 或空格前缀,
Decoder自动跳过,Unmarshal会报错,这点反而更鲁棒
dec := json.NewDecoder(resp.Body) err := dec.Decode(&v) // 直接解析,不经过 []byte 中转
别忽略 Content-Length 和 Transfer-Encoding: chunked 对性能的影响
Go 的 http.Server 默认启用 HTTP/1.1 chunked 编码回包,这对流式响应友好,但对小响应(如
立即学习“go语言免费学习笔记(深入)”;
- 若响应体长度确定且稳定,显式设
Content-Length并关闭 chunked,可省去编码+解码环节 - 用
responseWriter.Header().Set("Content-Length", strconv.Itoa(len(body)))后,务必用Write而非WriteString确保字节数一致 - HTTP/2 下 chunked 无意义,该问题只存在于 HTTP/1.1 场景
实际压测中,transport 调优 + decoder 替换 + Content-Length 显式控制,三者叠加常能将 p99 延迟压低 30% 以上。最容易被跳过的其实是 MaxIdleConnsPerHost 的设置——它不写,连接池就按 host 隔离失效,再多的 MaxIdleConns 也没用。











