Go中的JSON POST请求：从新手到生产环境

在Go中发送JSON POST请求：从“这到底怎么工作”到“做完就忘了”

您是否曾经在Stack Overflow上纠结，试图理解为什么您的Go语言JSON POST请求不被服务器接受？很熟悉吧：看起来一切都对，但返回的却是400 Bad Request或空响应体。原来，在Go中有几种发送JSON的方法，选择正确的方法不仅仅是口味问题，而是关乎您微服务稳定性的问题。

在本文中，我们不仅仅是展示代码。我们将解析三种方法：从幼稚的（能工作但有风险）到带有正确错误处理和上下文的生产级解决方案。如果您用Go编写API、机器人或集成，这是必读内容。

为什么这个话题如此受欢迎？

Go是用于网络服务的语言。迟早每个开发者都会遇到这样的任务：“在POST请求体中发送JSON”。看起来有什么难的？但细节很多：

• 需要正确地将结构体序列化为JSON（编组）。
• 重要的是不要忘记 Content-Type: application/json 头。
• 需要正确关闭响应体。
• 希望避免内存泄漏和恐慌。

让我们用实际例子来解析每种方法。

方法1：“临时凑合”——bytes.NewBuffer + json.Marshal

这是最简单的方法。获取一个结构体，将其编组为字节，放入缓冲区并发送。许多Go初学者就是这样写的。

package main

import (    "bytes"    "encoding/json"    "fmt"    "net/http")

type User struct {    Name  string `json:"name"`    Email string `json:"email"`}

func main() {    user := User{Name: "伊万·彼得罗夫", Email: "ivan@example.com"}        // 步骤1：将结构体编组为JSON    jsonData, err := json.Marshal(user)    if err != nil {        fmt.Println("编组错误:", err)        return    }        // 步骤2：创建POST请求    resp, err := http.Post(        "https://api.example.com/users",        "application/json",        bytes.NewBuffer(jsonData),    )    if err != nil {        fmt.Println("请求错误:", err)        return    }    defer resp.Body.Close()        fmt.Println("状态:", resp.Status)}

这种方法的优缺点

• 优点： 代码最少，新手易懂。
• 缺点： 没有灵活性。您无法添加自定义头（授权、trace-id）。无法控制超时。如果服务器返回错误——您无法处理它。
• 缺点： 潜在问题：如果 json.Marshal 返回错误，您会捕获它，但在实际代码中经常忘记检查。

这种方法适用于原型和测试。对于生产环境——不行。

方法2：“正确的”——http.NewRequest + json.NewEncoder

Go社区推荐使用 http.NewRequest 和 json.NewEncoder。为什么？因为它提供了对请求的完全控制，并且内存效率更高。

package main

import (    "bytes"    "encoding/json"    "fmt"    "net/http"    "time")

type Order struct {    ID     int     `json:"id"`    Amount float64 `json:"amount"`    Items  []string `json:"items"`}

func sendOrder(order Order) error {    // 创建缓冲区和编码器    var buf bytes.Buffer    enc := json.NewEncoder(&buf)        // 直接编码到缓冲区（无需中间[]byte）    if err := enc.Encode(order); err != nil {        return fmt.Errorf("JSON编码错误: %w", err)    }        // 创建请求    req, err := http.NewRequest("POST", "https://api.example.com/orders", &buf)    if err != nil {        return fmt.Errorf("创建请求错误: %w", err)    }        // 设置头    req.Header.Set("Content-Type", "application/json")    req.Hea