如何使用Golang构建简单HTTP客户端_Golang net/http请求处理方法

最简GET请求需检查err并defer关闭resp.Body;生产环境应自定义http.Client设超时、复用连接;POST等复杂请求须用http.NewRequest+Do;重定向、Cookie、代理等行为可通过Client和Transport字段精细控制。

http.Get 发起最简 GET 请求,但别忽略错误和响应体关闭

直接调用 http.Get 是最快启动方式,但它只支持 GET,且返回的 *http.Response 必须手动关闭 Body,否则会泄漏 HTTP 连接。

  • 必须检查 err:网络不可达、DNS 失败、TLS 握手失败都会让 err != nil
  • resp.Body 一定要 defer resp.Body.Close(),哪怕你只读前几个字节
  • resp.StatusCode 不是 2xx 时,resp.Body 仍可能含服务端错误信息,建议读取并记录
resp, err := http.Get("https://httpbin.org/get")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body) fmt.Printf("status: %d, body: %s", resp.StatusCode, string(body))

http.Client 自定义超时、重试与复用连接

http.Get 底层用的是默认 http.DefaultClient,它没有设置超时,容易卡死;生产环境必须显式构造带配置的 *http.Client

  • 超时要分三段设:Timeout(总耗时)、Transport.DialContext(建连)、Transport.TLSHandshakeTim

    eout
    (TLS)
  • 连接复用靠 http.Transport:默认已启用,但需注意 MaxIdleConnsMaxIdleConnsPerHost,高并发下不调大会成为瓶颈
  • 重试需手动实现——http.Client 本身不重试失败请求(如 502、连接中断),得在外层加 for 循环 + 指数退避
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,
    },
}

发送 POST 表单或 JSON 用 http.NewRequest + client.Do

http.Post 看似简单,但无法设 Header、无法复用 http.Client 配置,也不支持流式写入。真实场景一律走 http.NewRequest 构造再 Do

  • POST JSON:用 json.Marshal 序列化后传给 bytes.NewReader,Header 必须设 "Content-Type": "application/json"
  • 表单提交:用 url.Values{"key": {"value"}}.Encode(),Header 设 "Content-Type": "application/x-www-form-urlencoded"
  • 大文件上传或流式请求:避免一次性加载全部数据到内存,改用 io.Pipe 或直接传 io.Reader
data := map[string]string{"name": "gopher"}
jsonBytes, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://httpbin.org/post", bytes.NewReader(jsonBytes))
req.Header.Set("Content-Type", "application/json")

resp, err := client.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close()

处理重定向、Cookie、代理等高级行为要改 http.Client.CheckRedirecthttp.Transport

默认 http.Client 会自动跟随 301/302,最多 10 次,且不携带 Cookie;需要精细控制就得干预。

  • 禁用重定向:设 CheckRedirect 返回 http.ErrUseLastResponse
  • 跨域带 Cookie:需设 req.Header.Set("Cookie", "..."),且服务端必须响应 Access-Control-Allow-Credentials: true
  • 走代理:在 http.Transport 中设 Proxy: http.ProxyURL(...)Proxy: http.ProxyFromEnvironment
  • 自签名证书:通过 Transport.TLSClientConfig.InsecureSkipVerify = true(仅测试用)

复杂逻辑下,http.Client 不是黑盒——它的每个字段都可按需调整,关键在理解哪些行为由 Client 控制,哪些由 Transport 承担。