Golang发送POST请求与JSON提交方法

本文深入剖析了Go语言中发送JSON格式POST请求的常见陷阱与最佳实践，重点指出直接使用http.Post会导致Content-Type缺失而引发415错误，强调必须通过http.NewRequest配合显式设置application/json头；同时警示忽略json.Marshal错误、遗漏结构体json tag、手写JSON字符串以及未配置HTTP客户端超时等高频隐患，并给出安全、健壮、可维护的完整解决方案——从序列化校验、头部设置到超时控制，每一步都直击生产环境痛点，助你写出真正可靠的服务间通信代码。

http.Post 默认不设置 Content-Type，JSON 会被当成纯文本

Go 的 http.Post 是个“裸”函数，它只封装了方法和 body，**完全不管 header**。如果你直接传 JSON 字符串进去，服务端收到的 Content-Type 是 text/plain; charset=utf-8，绝大多数 REST API 会直接拒收或解析失败。

• 正确做法是改用 http.NewRequest + http.DefaultClient.Do，手动设 Content-Type: application/json
• 别图省事硬套 http.Post，它适合发表单或纯文本，不适合 JSON
• 常见错误现象：415 Unsupported Media Type 或后端解析出空对象

json.Marshal 后必须检查 error，否则 panic 可能发生在生产环境

Go 的 json.Marshal 在遇到不可序列化的字段（比如含 func、chan、循环引用）时会返回非 nil error。但很多人写成 body, _ := json.Marshal(data)，把 error 忽略了——这时候 body 是 nil，http.NewRequest 会 panic。

• 永远显式处理 json.Marshal 的 error，哪怕只是 log 后 return
• 结构体字段要加 json: tag，否则默认导出字段名可能不匹配后端约定
• 如果 data 是 map 或 interface{}，确保值类型是 JSON 可序列化的（int, string, bool, nil, slice, map）

不要用 strings.NewReader 拼接 JSON 字符串发请求

有人把 JSON 写成字符串字面量再用 strings.NewReader 包一层传给 http.Post，看着短，实则隐患多：中文乱码、引号转义漏掉、结构稍一变就难维护。

• JSON 应该由 json.Marshal 生成，不是手写字符串
• strings.NewReader 返回的是 *strings.Reader，而 http.Post 要求 io.Reader ——虽然能用，但绕过类型安全检查
• 性能上没差别，但可读性和可维护性差一个数量级

超时控制必须显式设置，DefaultClient 会无限等待

http.DefaultClient 的 Timeout 是 0，意味着无超时。网络抖动、服务假死时，你的 goroutine 就卡死了，积压越来越多。

• 用自定义 client：

  client := &http.Client{Timeout: 10 * time.Second}

• 别依赖 http.DefaultClient 做线上请求，尤其在微服务调用中
• 如果需要更细粒度控制（比如连接超时 vs 读写超时），用 http.Transport 配置

实际最常漏掉的是超时和 Content-Type，这两项不设，代码在本地测得通，上线就出问题。JSON 序列化本身简单，但边界条件（空值、嵌套、错误处理）必须每处都盯住。

理论要掌握，实操不能落！以上关于《Golang发送POST请求与JSON提交方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！