Go语言发送HTTP请求全攻略

本文深入解析了Go语言中使用net/http发起HTTP请求的核心要点与常见陷阱，强调http.Get虽简洁但必须defer resp.Body.Close()以防连接泄漏，POST应优先选用http.NewRequest配合自定义Client以灵活控制Header、超时和Content-Type，指出仅靠time.After无法真正中断底层TCP连接，必须通过带Timeout的http.Client或精细配置Transport来避免goroutine堆积，同时警示JSON序列化/反序列化时务必检查marshal/unmarshal错误并确保完整读取Body，最后点明超时控制、Body关闭、JSON错误处理和状态码校验这四大坑在真实项目中几乎不可避免——稍有疏忽便可能导致连接耗尽、内存泄漏或静默失败。

用 net/http 发起 GET 请求最简写法

Go 标准库不通过 net 包发 HTTP 请求，而是用 net/http。直接调用 http.Get 是最快上手方式，它内部封装了连接、请求头、状态码处理等细节。

注意：http.Get 返回的 *http.Response 必须手动关闭 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.Println(string(body))

POST 请求要手动构造 *http.Request

http.Post 虽然存在，但只支持固定 Content-Type（如 application/x-www-form-urlencoded），灵活性差。真正可控的方式是用 http.NewRequest + http.DefaultClient.Do。

• http.Post 无法设置自定义 Header（比如 Authorization）
• http.NewRequest 允许你精确控制 Method、URL、Body、Header、Timeout
• 务必检查 resp.StatusCode，http.Do 不会因 4xx/5xx 自动报错

req, _ := http.NewRequest("POST", "https://httpbin.org/post", strings.NewReader(`{"name":"go"}`))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer abc123")
client := &http.Client{Timeout: 10 * time.Second}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != 200 {
log.Printf("unexpected status: %d", resp.StatusCode)
}

超时控制必须用 http.Client，不能靠 time.After

仅对 http.Get 或 http.Post 包一层 time.AfterFunc 无法中断底层 TCP 连接，可能造成 goroutine 泄漏。正确做法是创建带 Timeout 的 *http.Client，或更细粒度地设置 Transport 的 DialContext 和 ResponseHeaderTimeout。

• Client.Timeout 控制整个请求生命周期（DNS + 连接 + 写请求 + 读响应头 + 读响应体）
• 若需分别控制连接超时和读响应超时，需自定义 http.Transport
• 零值 http.Client{} 没有超时，可能无限 hang 住

client := &http.Client{
    Timeout: 5 * time.Second,
    Transport: &http.Transport{
        DialContext: (&net.Dialer{
            Timeout:   3 * time.Second,
            KeepAlive: 30 * time.Second,
        }).DialContext,
        ResponseHeaderTimeout: 2 * time.Second,
    },
}

JSON 请求和响应的典型错误点

用 json.Marshal 构造请求体时，容易忽略错误；用 json.Unmarshal 解析响应时，常忘记先读完 resp.Body。这两步出错都不会触发 HTTP 状态码异常，但会导致静默失败。

• json.Marshal 失败返回 nil 字节切片，传给 bytes.NewReader 后发空体
• resp.Body 是流式读取，多次调用 json.NewDecoder(resp.Body).Decode() 会报 io.EOF
• 结构体字段没加 json: tag，导致序列化/反序列化字段为空

data := struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}{"go", 15}
body, err := json.Marshal(data)
if err != nil {
log.Fatal(err) // 必须检查
}
req, _ := http.NewRequest("POST", url, bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
log.Fatal(err) // 必须检查
}

HTTP 请求看似简单，但超时、Body 关闭、JSON 序列化错误、状态码忽略这四点，在真实项目里几乎必踩。尤其 Body 不关，压测时连接池迅速耗尽。

终于介绍完啦！小伙伴们，这篇关于《Go语言发送HTTP请求全攻略》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！