如何使用Golang net http发送请求_Golang HTTP客户端基础用法

Go HTTP客户端需显式设置超时、复用client、定制Transport、正确关闭resp.Body并设Content-Type,否则易致超时卡死、连接泄漏或解析失败。

Go 的 net/http 客户端默认就足够健壮,不需要额外封装就能发请求,但直接用 http.Gethttp.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.C

lose()
  • Timeout 控制整个请求生命周期(DNS + 连接 + TLS + 写请求 + 读响应),不是单个阶段的超时
  • 不要在每次请求都 new 一个 http.Client,它本身是线程安全且设计为复用的
  • 如果需要更细粒度控制(比如单独设连接超时),得配 Transport

如何 POST JSON 并读取响应体

http.Post 发 JSON 很容易漏掉 Content-Type 头,导致后端解析失败;同时响应体必须手动读取并关闭,否则连接无法复用。

推荐用 http.NewRequest + client.Do 组合,可控性更强:

data := map[string]string{"name": "Alice"}
jsonBytes, _ := json.Marshal(data)

req, _ := http.NewRequest("POST", "https://www./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
  • MaxIdleConnsMaxIdleConnsPerHost 太小 → 连接池不够用,频繁重连:建议设为 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 设置,每个点漏掉都可能在线上突然爆发。