生产环境必须显式构造带超时和连接复用的http.Client,禁用http.Get;需设Timeout、MaxIdleConnsPerHost,并始终Close resp.Body;JSON解析应先ReadAll再Unmarshal。

用 http.Get 发起最简 GET 请求,但别直接用它处理生产流量
多数人第一反应是 http.Get,它确实一行就能发请求:
resp, err := http.Get("https://api.example.com/data")但问题在于它用的是默认的全局 http.DefaultClient,没有超时控制、不复用连接、无法加中间件(如日志、重试)。一旦后端响应慢或卡住,goroutine 就会永久阻塞。生产环境必须显式构造带超时的 http.Client。
设置超时和复用连接:自己 new 一个 http.Client
关键不是“怎么发”,而是“怎么安全地发”。以下是最小可行配置:
client := &http.Client{
Timeout: 10 * time.Second,
Transport: &http.Transport{
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
IdleConnTimeout: 30 * time.Second,
},
}
resp, err := client.Get("https://api.example.com/data")注意三点:
-
Timeout是整个请求生命周期上限(DNS + 连接 + 写请求 + 读响应),不是仅读超时 -
MaxIdleConnsPerHost必须设,否则默认是 2,高并发下会排队等连接 - 别漏掉
resp.Body.Close(),否则底层 TCP 连接不会归还给连接池,迟早耗尽文件描述符
解析 JSON 响应时,json.Unmarshal 要配合 io.ReadAll,别用 resp.Body 直接解
resp.Body 是个 io.ReadCloser,只能读一次,且不能 seek。常见错误写法:
var data map[string]interface{}
err := json.NewDecoder(resp.Body).Decode(&data) // ❌ 可能 panic 或读不全正确做法是先完整读取再解码:body, err := io.ReadAll(resp.Body)
if err != nil { /* 处理读取失败 */ }
defer resp.Body.Close() // 注意:Close 必须在 ReadAll 后调用
var data map[string]interface{}
err = json.Unmarshal(body, &data)
如果响应体很大,才考虑用 json.NewDecoder 流式解析,但绝大多数 API 返回几十 KB,直接 ReadAll 更稳妥、更少出错。
POST 表单或 JSON?选对 Content-Type 和数据构造方式
发 POST 不是只换方法名就行。后端认的是 Content-Type 和实际 payload 格式:
- 发表单:
http.PostForm("https://api.example.com/login", url.Values{"user": {"foo"}, "pass": {"bar"}}),自动设Content-Type: application/x-www-form-urlencoded - 发 JSON:
bytes, _ := json.Marshal(map[string]string{"key": "value"}),然后http.NewRequest("POST", url, bytes),手动设req.Header.Set("Content-Type", "application/json") - 别用
http.Post简化版——它不支持自定义 header,也不方便复用 client
application/json,你传了 text/plain 却没意识到。HTTP 客户端真正难的不是语法,是连接管理、错误重试边界、Body 生命周期和 Content-Type 对齐——这些地方一疏忽,服务跑几天就莫名变慢或报错。










