go中自定义http.Client需设置超时、连接池、Header、代理、TLS及cookie:必设Timeout与Transport参数,Header用req.Header.Set(),代理和跳过证书仅限调试,Cookie通过Jar自动管理或手动添加。

在 Go 中使用 http.Client 自定义 HTTP 请求,核心在于控制请求的超时、重试、Header、代理、TLS 配置以及 Cookie 等行为。默认的 http.DefaultClient 很方便,但生产环境通常需要更精细的控制。
自定义超时与连接池
避免请求无限挂起或资源耗尽,必须设置超时,并复用连接:
- Timeout:控制整个请求生命周期(dns + 连接 + 写请求 + 读响应)
- Transport 的 DialContext 和 TLSHandshakeTimeout:细化底层连接行为
- MaxIdleConns / MaxIdleConnsPerHost:防止连接过多,提升复用率
示例:
client := &http.Client{ Timeout: 10 * time.Second, Transport: &http.Transport{ DialContext: (&net.Dialer{ Timeout: 5 * time.Second, KeepAlive: 30 * time.Second, }).DialContext, TLSHandshakeTimeout: 5 * time.Second, MaxIdleConns: 100, MaxIdleConnsPerHost: 100, IdleConnTimeout: 30 * time.Second, }, }
设置请求头与基础认证
多数 API 要求 Authorization、User-Agent 或自定义 Header:
立即学习“go语言免费学习笔记(深入)”;
- 直接在
*http.Request上调用req.Header.Set() - 基础认证可用
req.SetBasicAuth(user, pass) - 注意:某些 Header(如
Host、Content-Length)由 net/http 自动设置,手动设可能被忽略或报错
示例:
req, _ := http.NewRequest("GET", "https://api.example.com/data", nil) req.Header.Set("User-Agent", "Myapp/1.0") req.Header.Set("X-API-Key", "abc123") req.SetBasicAuth("user", "pass")
使用代理与跳过证书验证(仅测试)
开发调试时可能需走本地代理(如 Charles/fiddler),或访问自签名 HTTPS 服务:
- 代理通过
http.proxyURL或http.ProxyFromEnvironment设置 - 跳过 TLS 验证仅限非生产环境,需自定义
Transport.TLSClientConfig - 务必避免在正式代码中保留
InsecureSkipVerify: true
示例:
proxyURL, _ := url.Parse("http://127.0.0.1:8888") client := &http.Client{ Transport: &http.Transport{ Proxy: http.ProxyURL(proxyURL), TLSClientConfig: &tls.Config{ InsecureSkipVerify: true, // ⚠️ 仅调试用 }, }, }
携带 Cookie 与管理会话
若需保持登录态,可手动添加 Cookie,或启用自动 Cookie 管理:
- 手动添加:
req.AddCookie(&http.Cookie{Name: "session_id", Value: "xxx"}) - 自动管理:用
http.CookieJar,配合cookiejar.New(nil) - 注意:默认 Client 不带 Jar,需显式设置
Client.Jar
示例(自动管理):
jar, _ := cookiejar.New(nil) client := &http.Client{ Jar: jar, } // 后续请求自动附带服务端 Set-Cookie 返回的 Cookie
基本上就这些。关键不是堆砌配置,而是按需开启:超时必设、Header 按协议填、代理和跳证书只在对应场景开、Cookie 看是否需要会话维持。不复杂但容易忽略。