正确做法是构造带超时的http.client实例,用context.withtimeout控制单次请求生命周期,复用client并配置transport参数,显式关闭resp.body,检查statuscode并解析错误响应体。

如何用 http.Client 发起带超时的 GET 请求
Go 默认的 http.Get 没有超时控制,生产环境必须避免直接使用。正确做法是构造带超时的 http.Client 实例:
- 用
context.WithTimeout控制单次请求生命周期,比仅设Client.Timeout更精准(后者不中断已发起的底层连接) -
http.Client是可复用的,不要每次请求都新建——它内部维护连接池,频繁新建会导致net/http: request canceled (Client.Timeout exceeded while awaiting headers) - 示例中必须显式调用
resp.Body.Close(),否则连接不会归还到连接池,长期运行会耗尽文件描述符
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", "https://api.example.com/data", nil)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
// 注意:err 可能是 context.DeadlineExceeded、net.OpError 等
return
}
defer resp.Body.Close() // 关键
POST JSON 数据并检查状态码与错误响应体
很多接口返回非 2xx 状态码但附带 JSON 错误信息(如 {"error":"invalid_token"}),只判 err != nil 会漏掉这类业务错误。
- 先检查
resp.StatusCode是否在 200–299 范围,再读取resp.Body - 用
ioutil.ReadAll(Go 1.16+ 改为io.ReadAll)读完整响应体,避免后续读取失败 - 若服务端返回 400/401/500 且含 JSON 错误,应解析该 body 而非忽略
- 注意:
resp.Body只能读一次,解析失败后无法重试
resp, err := client.Do(req)
if err != nil {
log.Printf("request failed: %v", err)
return
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
var e struct{ Error string }
json.Unmarshal(body, &e)
log.Printf("API error %d: %s", resp.StatusCode, e.Error)
return
}
// 正常处理 body
如何复用连接、避免 dial tcp: lookup xxx: no such host 或连接激增
默认 http.Client 的 Transport 对 DNS 解析和空闲连接管理较保守,高并发下易触发 DNS 失败或新建大量 TCP 连接。
- 设置
Transport.MaxIdleConns和MaxIdleConnsPerHost(建议至少 100),否则默认 2 个空闲连接会频繁断连重连 - 启用
Transport.IdleConnTimeout(如 30s),防止 NAT 设备或防火墙主动断开长空闲连接 - DNS 缓存问题常见于容器环境:可设
Transport.DialContext+net.Resolver并缓存结果,或直接使用github.com/miekg/dns自定义解析逻辑 - 若服务端是 Kubernetes Ingress,注意其默认连接空闲超时可能短于客户端设置,需两端对齐
处理重定向、Cookie 和 Basic Auth 的实际要点
http.Client 默认自动跟随 301/302 重定向,但某些场景需干预;Cookie 和认证也常被忽略细节。
立即学习“go语言免费学习笔记(深入)”;
- 禁用自动重定向:设
CheckRedirect返回http.ErrUseLastResponse,否则重定向后的 Cookie 不会自动带上(尤其跨域时) - 手动管理 Cookie:用
cookiejar.New创建 jar 并赋给Client.Jar,否则每次请求都是无状态的 - Basic Auth 推荐用
req.SetBasicAuth(user, pass),而非手动拼Authorizationheader——它会自动 base64 编码并处理特殊字符 - 注意:若服务端返回 307/308,
http.Client默认不重放 POST body,需自定义CheckRedirect逻辑










