Golang发送JSON请求方法详解

对于一个Golang开发者来说，牢固扎实的基础是十分重要的，golang学习网就来带大家一点点的掌握基础知识点。今天本篇文章带大家了解《Golang发送JSON请求方法详解》，主要介绍了，希望对大家的知识积累有所帮助，快点收藏起来吧，否则需要时就找不到了！

最直接方式是用http.Post发送固定JSON请求，但需json.Marshal后bytes.NewReader包装；更推荐http.Client+http.NewRequest以精确控制超时、header等。

用 http.Post 发送简单 JSON 请求最直接

如果只是发一个固定结构的 JSON 到某个 API，不需要自定义 header 或复用 client，http.Post 是最快路径。它自动设置 Content-Type: application/json，但注意：它不处理错误响应体，只检查网络层错误。

• http.Post 第三个参数必须是 io.Reader，不能直接传 struct；得先用 json.Marshal 编码成字节切片，再用 bytes.NewReader 包装
• 返回的 *http.Response 需要手动调用 resp.Body.Close()，否则会泄漏连接
• 它默认使用全局 http.DefaultClient，不支持超时控制——这点在生产环境容易出问题

data := map[string]string{"name": "alice", "role": "dev"}
payload, _ := json.Marshal(data)
resp, err := http.Post("https://api.example.com/users", "application/json", bytes.NewReader(payload))
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

用 http.Client + http.NewRequest 精确控制请求行为

多数真实场景需要设置超时、自定义 header、复用连接或处理 4xx/5xx 响应体，这时必须自己构造 *http.Request 并用 *http.Client 发送。

• http.NewRequest 不会自动设 Content-Type，必须显式调用 req.Header.Set("Content-Type", "application/json")
• http.Client.Timeout 控制整个请求生命周期（DNS + 连接 + 写入 + 读取），不是仅连接超时
• 若需更细粒度控制（比如只限制后端响应时间），得用 context.WithTimeout 传给 client.Do

client := &http.Client{
    Timeout: 10 * time.Second,
}
data := struct{ Name string }{"bob"}
payload, _ := json.Marshal(data)
req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(payload))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xyz")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()

接收 JSON 响应时别忘了检查 resp.StatusCode

http.Client.Do 只在网络失败时返回 error，HTTP 状态码如 400 Bad Request 或 502 Bad Gateway 都算“成功响应”，必须手动判断。否则可能把错误响应当正常数据解码，导致 panic 或逻辑错乱。

• 常见误操作：直接对 resp.Body 调用 json.Decode，却不检查 resp.StatusCode < 400
• 建议统一处理：状态码非 2xx 时，先读取并记录 resp.Body 内容（用于调试），再返回错误
• 注意 resp.Body 只能读一次；如果日志里已读过，后续 json.Decode 会得到空数据

结构体字段导出与 JSON tag 决定序列化结果

Go 的 json.Marshal 只序列化导出字段（首字母大写），且受 json: tag 控制。没加 tag 时默认用字段名小写，但嵌套或命名不一致时极易出错。

• 字段名含下划线（如 User_id）不会自动转成 user_id，必须显式写 json:"user_id"
• 想忽略空值字段，用 json:",omitempty"；但要注意：零值字符串 ""、数字 0、布尔 false 都会被跳过
• 私有字段（小写开头）无论有没有 tag，都不会被编码——这不是 bug，是 Go 的反射规则

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"`
    token string `json:"token"` // 这个字段不会出现在 JSON 中
}

真正容易卡住的地方，往往不是怎么发，而是响应状态码没检查、Body 被重复读、或者结构体字段没导出却以为能序列化。

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