Golang发送POST请求方法详解

Go语言发送POST请求主要用net/http包，首先推荐使用http.Post发送表单数据，适用于application/x-www-form-urlencoded类型，自动设置Content-Type，但无法自定义Header或发送JSON；更灵活的方式是使用http.NewRequest配合http.DefaultClient.Do，先通过json.Marshal将结构体转为JSON字节，再用bytes.NewReader构造Body，手动设置Header如Content-Type为application/json；生产环境建议显式创建http.Client并设置Timeout（如10秒），避免默认客户端的连接池和超时问题；可自定义Header添加Authorization、User-Agent等字段；响应处理需defer resp.Body.Close()，用io.ReadAll读取Body，并检查StatusCode是否为2xx以判断请求成功；常见错误包括未关闭响应体导致连接泄露、JSON序列化时字段未导出导致为空、未设Content-Type或用http.Post发JSON但未修改类型导致后端解析失败。

Go语言发送POST请求很简单，核心是用net/http包的http.Post或更灵活的http.NewRequest配合http.DefaultClient.Do。

使用 http.Post 快速发简单表单数据

适合发送application/x-www-form-urlencoded类型的键值对，比如登录、提交表单。

注意：它自动设置Content-Type，但不支持自定义Header或复杂Body（如JSON）。

• 把数据用url.Values{}.Encode()转成URL编码字符串
• 调用http.Post(url, "application/x-www-form-urlencoded", strings.NewReader(data))
• 记得检查返回的*http.Response和error

用 http.NewRequest 发送 JSON 数据

这是最常用也最可控的方式，尤其对接API时几乎都用它。

• 先用json.Marshal把结构体转成字节切片
• 用bytes.NewReader(jsonBytes)构造io.Reader作为Body
• 创建http.NewRequest("POST", url, reader)，再手动设置req.Header.Set("Content-Type", "application/json")
• 用http.DefaultClient.Do(req)执行，别忘了defer resp.Body.Close()

带自定义Header和超时控制的完整写法

生产环境建议显式创建http.Client，避免复用默认客户端导致连接池问题或超时失控。

• 设置http.Client{Timeout: 10 * time.Second}
• 在req.Header里加Authorization、User-Agent等字段
• 读取响应时用io.ReadAll(resp.Body)，别直接用resp.Body指针多次读
• 检查resp.StatusCode是否在200–299范围内，避免把4xx/5xx当成功

常见错误提醒

这些小细节容易踩坑：

• 忘记Close()响应体 → 导致HTTP连接无法复用，后续请求变慢甚至超时
• JSON Body传了nil或未导出字段 → 发过去是空对象{}或报错
• 没设Content-Type却发JSON → 后端可能解析失败
• 用http.Post发JSON却不改Header → 服务端收到的是纯文本，不是JSON

基本上就这些。不复杂但容易忽略细节，写两次就熟了。