掌握Go语言net/http客户端需关注四点:1. 使用带超时的http.Client,通过context和Transport设置合理超时;2. 发送表单或JSON时正确设置Content-Type并构造Body;3. 复用Client实例并调优Transport参数以提升并发性能;4. 主动检查响应状态码、关闭Body并防范OOM。

Go 语言的 net/http 包提供了简洁、高效、并发友好的 HTTP 客户端能力。掌握基本用法之外,注意超时控制、错误处理、连接复用和请求定制等细节,才能写出健壮可靠的 HTTP 调用代码。
基础 GET 请求:别忘了设置超时
直接用 http.Get 最简单,但它使用默认客户端(无超时),线上服务容易因后端卡住而阻塞协程。推荐显式构造带超时的 http.Client:
- 用
context.WithTimeout控制整体请求耗时 - 设置
Transport的IdleConnTimeout和TLSHandshakeTimeout防止连接池僵死 - 示例中 5 秒总超时 + 3 秒空闲连接回收,是常见平衡点
POST 表单或 JSON:正确设置 Content-Type 和 Body
发送结构化数据时,Content-Type 和 Body 构造必须匹配,否则服务端可能解析失败:
-
表单提交用
url.Values{}.Encode(),Header 设为"application/x-www-form-urlencoded" - JSON 提交先
json.Marshal,再用bytes.NewReader包装,Header 设为"application/json" - 避免手动拼接 JSON 字符串或忽略 UTF-8 编码问题
复用连接与自定义 Transport:提升高并发性能
默认客户端每次请求都新建 TCP 连接,QPS 高时开销大。通过复用连接和调优 Transport 可显著改善:
立即学习“go语言免费学习笔记(深入)”;
- 全局复用一个
*http.Client实例(它本身是并发安全的) - 设置
MaxIdleConns和MaxIdleConnsPerHost控制连接池大小 - 禁用 HTTP/2(如需兼容老服务)可设
ForceAttemptHTTP2: false
错误处理与响应检查:别只看 err == nil
HTTP 状态码不是错误(如 404、500),resp.StatusCode 需主动判断;Body 必须关闭,否则连接无法复用:
- 总是检查
resp.StatusCode >= 400并按需处理业务错误 -
defer resp.Body.Close()必须放在if err != nil判断之后,且确保 resp 不为 nil - 读取 Body 前建议用
io.LimitReader(resp.Body, maxBytes)防止 OOM
基本上就这些。Golang 的 HTTP 客户端不复杂但容易忽略细节,把超时、复用、编码、错误四点理清楚,日常开发足够稳了。










