Go HTTP客户端需显式设置超时、复用client、定制Transport、正确关闭resp.Body并设Content-Type，否则易致超时卡死、连接泄漏或解析失败。
Go 的 net/http 客户端默认就足够健壮，不需要额外封装就能发请求，但直接用 http.Get 或 http.Post 容易踩坑——比如超时没设、连接复用被忽略、错误没检查。
怎么发一个带超时的 GET 请求
用 http.Get 看似简单，但它底层用的是默认的 http.DefaultClient，而这个客户端的 Timeout 是 0（即无限等待），线上服务几乎从不适用。
正确做法是显式构造一个带超时的 http.Client，再调用其 Get 方法：
client := &http.Client{
Timeout: 5 * time.Second,
}
resp, err := client.Get("https://httpbin.org/get")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()-
Timeout控制整个请求生命周期（DNS + 连接 + TLS + 写请求 + 读响应），不是单个阶段的超时 - 不要在每次请求都 new 一个
http.Client，它本身是线程安全且设计为复用的 - 如果需要更细粒度控制（比如单独设连接超时），得配
Transport
如何 POST JSON 并读取响应体
用 http.Post 发 JSON 很容易漏掉 Content-Type 头，导致后端解析失败；同时响应体必须手动读取并关闭，否则连接无法复用。
立即学习“go语言免费学习笔记（深入）”；
推荐用 http.NewRequest + client.Do 组合，可控性更强：
data := map[string]string{"name": "Alice"}
jsonBytes, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329", bytes.NewBuffer(jsonBytes))
req.Header.Set("Content-Type", "application/json")
client := &http.Client{Timeout: 5 * time.Second}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
-
bytes.NewBuffer把 JSON 字节转成io.Reader，这是http.Request构造函数要求的类型 - 必须显式设置
Content-Type，否则服务端常按text/plain解析 -
resp.Body一定要Close()，否则底层 TCP 连接会一直占用，最终耗尽连接池
为什么 HTTP 请求偶尔卡住或报错 “dial tcp i/o timeout”
这通常不是代码写错了，而是默认的 http.Transport 没调优，尤其在高并发或弱网环境下。
常见原因和对应调整点：
-
DialContext超时未设 → 导致 DNS 解析或建连卡死：需通过自定义Transport设置Dialer.Timeout -
MaxIdleConns和MaxIdleConnsPerHost太小 → 连接池不够用，频繁重连：建议设为 100 或更高 - 没设
IdleConnTimeout→ 空闲连接长期不释放，NAT 设备可能主动断开：建议设为 30 秒 - HTTPS 场景下没设
TLSHandshakeTimeout→ TLS 握手慢时阻塞整个请求
最小可用定制 Transport 示例：
transport := &http.Transport{
DialContext: (&net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
IdleConnTimeout: 30 * time.Second,
TLSHandshakeTimeout: 5 * time.Second,
}
client := &http.Client{Transport: transport, Timeout: 10 * time.Second}怎样复用 HTTP 连接提升性能
HTTP/1.1 默认支持 keep-alive，但前提是客户端和服务端都配合。Go 默认开启，但容易因配置不当失效。
确保连接复用生效的关键点：
- 使用同一个
http.Client实例（它内部复用Transport） - 服务端响应头包含
Connection: keep-alive（现代 Web Server 默认都有） - 请求 Host 域名一致（不同 Host 会走不同连接池）
- 避免手动设置
Connection: close头 - 及时
Close()resp.Body，否则连接无法归还到 idle 池
验证是否复用：抓包看 TCP 连接数是否稳定，或打印 resp.Header.Get("Connection") 和 resp.Header.Get("Keep-Alive")。
真正难的不是发一次请求，而是让成百上千次请求稳定、低延迟、不泄漏资源。超时、连接池、Body 关闭、Header 设置，每个点漏掉都可能在线上突然爆发。
