Golang发送POST请求教程及代码示例

本文深入讲解了在Golang中发送HTTP POST请求的两种核心方式：初学者可快速上手的`http.Post`（适合调试但缺乏灵活性），以及生产环境必备的自定义`http.Client`（支持超时控制、Header定制、连接复用和错误精细处理）；同时强调了JSON数据发送与响应解析的关键实践——必须手动检查状态码、及时关闭响应体、正确设置Content-Type，并系统梳理了415错误、空响应体、连接拒绝等高频问题的成因与排查技巧，助你写出健壮、可靠、可维护的Go HTTP客户端代码。

用 http.Post 发送简单表单数据

最直接的方式是调用 http.Post，它封装了常见场景：设置 Content-Type: application/x-www-form-urlencoded，自动编码键值对。

但要注意它不支持自定义超时、Header 或重试逻辑，仅适合调试或极简需求。

• 请求体必须是 io.Reader，所以常用 strings.NewReader 包裹 url.Values.Encode() 结果
• 返回的 *http.Response 必须手动关闭，否则会泄漏 HTTP 连接
• 错误只包含网络层或协议错误，HTTP 状态码（如 400、500）需自行检查 resp.StatusCode

resp, err := http.Post("https://httpbin.org/post", "application/x-www-form-urlencoded", strings.NewReader("name=alice&age=30"))
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close() // 必须加
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

用 http.Client 自定义 POST 请求

生产环境应使用 http.Client 实例，便于控制超时、复用连接、注入 Header 和处理重定向。

默认的 http.DefaultClient 没有设置超时，长时间阻塞会导致 goroutine 泄漏。

• 务必设置 Timeout 字段，推荐用 context.WithTimeout 更精细地控制
• 若需 JSON 数据，手动设置 Content-Type: application/json，并用 json.Marshal 序列化
• 上传文件或混合类型时，改用 multipart.Writer，不能直接传 JSON 字节流

client := &http.Client{
    Timeout: 10 * time.Second,
}
data := map[string]string{"name": "bob", "city": "shanghai"}
jsonBytes, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://httpbin.org/post", bytes.NewBuffer(jsonBytes))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer abc123")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()

处理 POST 返回的 JSON 响应

很多 API 返回 JSON，但容易忽略两个关键点：响应状态码非 2xx 时仍可能有有效 body；resp.Body 是流式读取，只能读一次。

• 先检查 resp.StatusCode，再决定是否解析 body
• 用 io.ReadAll 一次性读完，避免后续调用 json.Unmarshal 时因 body 已关闭或耗尽而失败
• 如果响应体很大，考虑用 json.NewDecoder(resp.Body) 流式解码，但需确保提前检查状态码

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
    body, _ := io.ReadAll(resp.Body)
    log.Printf("API error %d: %s", resp.StatusCode, string(body))
    return
}
var result map[string]interface{}
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
log.Fatal(err)
}

常见错误：空 body、415 错误、连接被拒绝

这三个错误高频出现，原因很具体：

• 415 Unsupported Media Type：没设 Content-Type Header，或值与实际 payload 不匹配（如发 JSON 却设成 application/x-www-form-urlencoded）
• 空 response body：忘记 defer resp.Body.Close() 导致下一次请求复用连接时读到残留数据；或未调用 io.ReadAll / json.Decode 就结束函数
• connection refused / timeout：目标地址写错（如少个 s 写成 http://）、服务未启动、防火墙拦截，或 http.Client.Timeout 设得太短

调试时优先打印 req.URL、req.Header 和 resp.StatusCode，比盲目重试更省时间。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~