Go net/http客户端需显式设超时、用NewRequest+Do发带Header/Body请求、复用Client并配CookieJar,且必须检查StatusCode、读取并关闭resp.Body。

Go 的 net/http 客户端默认够用,但直接用 http.Get 或 http.Post 很容易踩坑:超时没设、重定向失控、Cookie 不带、错误没判别。关键不是“能不能发”,而是“发得稳不稳”。
如何设置超时避免请求卡死
默认 HTTP 客户端没有超时,遇到网络异常或服务无响应会永久阻塞。必须显式配置 http.Client 的 Timeout 或更细粒度的 Transport 超时。
-
Timeout是整个请求生命周期上限(DNS + 连接 + 写请求 + 读响应) - 若需分别控制连接和读写,应自定义
http.Transport,设置DialContext、ResponseHeaderTimeout等 - 不要只靠
context.WithTimeout包裹Do—— 它无法中断底层 TCP 连接建立
client := &http.Client{
Timeout: 10 * time.Second,
}如何发送带 Header 和 Body 的 POST 请求
http.Post 看似简单,但不支持自定义 Header,也不方便复用连接。推荐统一用 http.NewRequest + client.Do。
- Body 必须是
io.Reader,JSON 数据建议用bytes.NewBuffer或strings.NewReader - 手动设置
Content-Type,比如application/json或application/x-www-form-urlencoded - 不要忘记检查
resp.StatusCode,http.Do成功只代表网络可达,不代表业务成功
req, _ := http.NewRequest("POST", "https://api.example.com/login", strings.NewReader(`{"user":"a","pass":"b"}`))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xyz")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
log.Printf("unexpected status: %d", resp.StatusCode)
}
如何复用连接并管理 Cookie
默认 http.Client 已启用连接复用(Keep-Alive),但 Cookie 默认不自动管理。需要显式传入 http.CookieJar 实例。
立即学习“go语言免费学习笔记(深入)”;
-
标准库提供
cookiejar.New,需传入&cookiejar.Options{PublicSuffixList: publicsuffix.List}(否则 jar 会拒绝设 Cookie) - 不要反复 new
http.Client,它本身是并发安全的,应复用全局实例 - 若需隔离 Cookie 上下文(如多用户登录),可为每个用户创建独立
http.Client并绑定专属 jar
jar, _ := cookiejar.New(&cookiejar.Options{PublicSuffixList: publicsuffix.List})
client := &http.Client{Jar: jar}常见错误:status code 200 但 body 为空或 panic
最常被忽略的是:没读完 resp.Body 就 close,或完全没读导致连接无法复用;更隐蔽的是,body 为 nil 时调用 ioutil.ReadAll(Go 1.16+ 已弃用)会 panic。
- 始终用
defer resp.Body.Close(),且在读取前检查resp.Body != nil - 用
io.ReadAll替代已废弃的ioutil.ReadAll - 大响应体建议用流式处理(
io.Copy或分块读),避免内存暴涨
if resp.Body != nil {
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
// 处理 body
}真正难的不是怎么发请求,而是怎么让每次请求都可预期:超时可控、状态可检、连接可复用、错误可追溯。把 http.Client 当成一个需要初始化、监控和回收的资源来看待,而不是随手 New 一下就扔进函数里。










