应显式构造带超时的 *http.Client,避免使用 http.Get;正确用 url.Values 拼接参数并 Set Header;禁用或自定义重定向逻辑;复用连接需配置 Transport 连接池;务必检查 resp.StatusCode 和 resp.Body。

Go 的 net/http 包自带的 HTTP 客户端足够轻量、可靠,不需要额外引入第三方库就能完成绝大多数请求任务;但直接用 http.Get 或 http.Post 容易忽略超时控制、重定向策略、Header 设置等关键细节,导致线上请求卡死或行为异常。
如何避免 http.Get 导致程序永久阻塞
http.Get 底层使用的是默认的 http.DefaultClient,而它的 Timeout 字段为 0 —— 即不设超时。一旦目标服务无响应或网络中断,goroutine 就会一直挂起。
- 永远不要在生产环境直接调用
http.Get或http.Post - 必须显式构造带超时的
*http.Client,例如:client := &http.Client{ Timeout: 10 * time.Second, } - 若需更精细控制(如分别设置连接、读、写超时),用
http.Transport配置:client := &http.Client{ Transport: &http.Transport{ DialContext: (&net.Dialer{ Timeout: 5 * time.Second, KeepAlive: 30 * time.Second, }).DialContext, TLSHandshakeTimeout: 5 * time.Second, ResponseHeaderTimeout: 5 * time.Second, }, }
如何正确设置请求头与 URL 参数
Go 不像 Python 的 requests 那样自动拼接 query string 或合并 headers;所有手动构造都需谨慎,尤其注意键名大小写和编码。
-
url.Values是拼接 query 的标准方式,它会自动做 URL 编码:params := url.Values{} params.Set("q", "golang http") params.Set("page", "1") resp, err := client.Get("https://api.example.com/search?" + params.Encode()) - Header 必须通过
req.Header.Set()设置,且 key 会按规范首字母大写(如"Content-Type"),不能直接赋值req.Header["Content-Type"] - POST 表单请求应设
Content-Type: application/x-www-form-urlencoded,并用strings.NewReader(params.Encode())传 body
如何处理重定向与 302/307 状态码
默认 http.Client 会自动跟随最多 10 次重定向,但某些场景(如调试登录跳转、抓取含中间页的资源)需要禁用或自定义逻辑。
立即学习“go语言免费学习笔记(深入)”;
- 禁用重定向:将
CheckRedirect设为返回http.ErrUseLastResponseclient := &http.Client{ CheckRedirect: func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse }, } - 若需记录跳转路径,可在
CheckRedirect中打印req.URL,但注意该函数在重定向前调用,req.URL是下一个要访问的地址 - 307 和 308 会保持原请求方法(如 POST 不会变 GET),而 301/302 默认转为 GET —— 这是 RFC 规范行为,不是 Go 特有
如何复用 TCP 连接提升性能
高频请求下,每次新建 TCP 连接开销显著;http.Transport 的连接池默认开启,但需确认配置未被意外关闭。
- 确保没有设置
DisableKeepAlives: true - 调整连接池参数可应对高并发:
Transport: &http.Transport{ MaxIdleConns: 100, MaxIdleConnsPerHost: 100, IdleConnTimeout: 30 * time.Second, } - 注意:
DefaultClient的连接池是全局共享的,多个业务共用时可能相互影响;建议按用途分 Client 实例 - HTTP/2 默认启用(只要服务端支持),无需额外配置,但要求 TLS 或 localhost 场景
最常被忽略的是:错误处理只检查 err != nil 不够,必须进一步检查 resp.StatusCode 和 resp.Body 是否为 nil;很多 “成功” 的 resp 其实是 4xx/5xx 状态,body 可能含错误详情。










