Go语言通过encoding/json和net/http包实现JSON处理,1. 使用json.NewDecoder解析请求体到结构体;2. 用json.NewEncoder或json.Marshal返回JSON响应;3. 通过struct标签自定义字段映射;4. 可用map[string]interface{}处理未知结构。

在Go语言中处理JSON请求与响应是Web开发中的常见需求,特别是在构建RESTful API时。Golang通过标准库encoding/json提供了强大且简洁的支持,结合net/http包可以轻松实现JSON数据的解析与序列化。
1. 解析JSON请求(反序列化)
当客户端发送JSON格式的数据到服务器时,你需要将请求体中的JSON数据解析为Go结构体。使用json.Unmarshal方法即可完成这一操作。
示例:定义结构体并解析请求
type User struct {
Name string `json:"name"`
Email string `json:"email"`
Age int `json:"age"`
}
func createUser(w http.ResponseWriter, r *http.Request) {
var user User
// 读取请求体
body, err := io.ReadAll(r.Body)
if err != nil {
http.Error(w, "无法读取请求体", http.StatusBadRequest)
return
}
defer r.Body.Close()
// 解析JSON
if err := json.Unmarshal(body, &user); err != nil {
http.Error(w, "无效的JSON格式", http.StatusBadRequest)
return
}
// 使用解析后的数据
fmt.Printf("收到用户: %+v\n", user)}
立即学习“go语言免费学习笔记(深入)”;
简化方式:直接解码
你也可以使用json.NewDecoder直接从r.Body解码,节省内存:
if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
http.Error(w, "解析JSON失败", http.StatusBadRequest)
return
}
2. 返回JSON响应(序列化)
将Go数据结构转换为JSON并返回给客户端,使用json.Marshal或json.NewEncoder。
示例:返回JSON响应
func getUser(w http.ResponseWriter, r *http.Request) {
user := User{
Name: "Alice",
Email: "alice@example.com",
Age: 30,
}
w.Header().Set("Content-Type", "application/json")
if err := json.NewEncoder(w).Encode(user); err != nil {
http.Error(w, "生成JSON失败", http.StatusInternalServerError)
}}
立即学习“go语言免费学习笔记(深入)”;
说明:
- 设置Content-Type: application/json是良好实践。
- json.NewEncoder(w).Encode()会自动添加换行,适合流式输出。
3. 结构体标签(Struct Tags)控制JSON字段名
Go结构体字段默认使用字段名作为JSON键,但通常需要自定义。通过json:标签可以指定映射关系。
type Product struct {
ID int `json:"id"`
Title string `json:"title"`
Price float64 `json:"price"`
IsAvailable bool `json:"in_stock"` // 自定义字段名
SecretKey string `json:"-"` // 不导出该字段
}
使用"-"可以忽略某些敏感字段,防止意外暴露。
4. 处理动态或未知结构的JSON
如果不知道JSON的具体结构,可以使用map[string]interface{}或interface{}接收。
var data map[string]interface{}
if err := json.NewDecoder(r.Body).Decode(&data); err != nil {
http.Error(w, "无效JSON", http.StatusBadRequest)
return
}
fmt.Println(data["name"], data["age"])
适用于Webhook、配置接收等场景,但需注意类型断言安全。
基本上就这些。Golang对JSON的支持简洁高效,配合结构体和标准库就能满足大多数Web服务需求。关键在于正确使用结构体标签、错误处理和内容类型设置。










