如何在Golang中处理JSON API请求与响应_Golang JSON API请求响应处理方法汇总
定义结构体并使用json标签处理JSON序列化与反序列化，通过json.Marshal发送POST请求，用json.NewDecoder解析响应，结合net/http包处理状态码与错误，支持嵌套结构与动态字段。
在Golang中处理JSON API请求与响应是构建现代Web服务和客户端调用的常见需求。Go标准库提供了encoding/json、net/http等包，配合结构体标签（struct tags）可以高效地完成序列化与反序列化。以下是常用的处理方法汇总。
定义结构体以映射JSON数据
处理JSON的第一步是定义Go结构体，使用json:标签来控制字段的序列化行为。
例如，一个用户信息的响应结构：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"`
}
omitempty表示当Email为空时，该字段不会出现在输出JSON中。这是控制可选字段的重要方式。
发送JSON请求（POST/PUT）
向API发送JSON数据通常用于创建或更新资源。需要将结构体编码为JSON，并设置正确的Content-Type头。
示例：发送POST请求创建用户
user := User{Name: "Alice", Email: "alice@example.com"}
jsonData, _ := json.Marshal(user)
resp, err := http.Post("https://api.example.com/users", "application/json", bytes.NewBuffer(jsonData))
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
关键点：
- 使用
json.Marshal将结构体转为JSON字节流 - 请求Body需包装为
bytes.NewBuffer - Header设置
Content-Type: application/json（某些API强制要求）
解析JSON响应
从API接收JSON后，通常需要反序列化到结构体中。
示例：读取GET响应并
解析
resp, err := http.Get("https://api.example.com/users/1")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var user User
if err := json.NewDecoder(resp.Body).Decode(&user); err != nil {
log.Fatal(err)
}
fmt.Printf("User: %+v\n", user)
这里使用json.NewDecoder直接从io.Reader（如resp.Body）解码，适合处理HTTP响应流。
处理嵌套JSON与动态字段
实际API中常有嵌套结构或不确定字段。可通过嵌套结构体或使用map[string]interface{}处理。
例如处理包含元数据的响应：
type Response struct {
Data User `json:"data"`
Meta map[string]interface{} `json:"meta"`
}
若字段类型不固定，可用interface{}接收，再通过类型断言提取值：
if version, ok := response.Meta["version"].(string); ok {
fmt.Println("Version:", version)
}
错误处理与状态码判断
不要忽略HTTP状态码。即使请求返回，也可能携带错误信息。
建议做法：
if resp.StatusCode != http.StatusOK {
var errorResp map[string]string
json.NewDecoder(resp.Body).Decode(&errorResp)
log.Fatal("API error:", errorResp["message"])
}
很多API在非200状态时仍返回JSON格式错误，应尝试解析并提示用户。
基本上就这些。掌握结构体标签、json.Marshal/Unmarshal、http.Client的基本用法，就能应对大多数JSON API场景。关键是设计好结构体，合理处理空值和错误响应。
