GolangJSON请求响应处理全解析

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang处理JSON请求响应方法详解》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

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"`
}
<p>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()</p><pre class="brush:php;toolbar:false;">// 解析JSON
if err := json.Unmarshal(body, &user); err != nil {
    http.Error(w, "无效的JSON格式", http.StatusBadRequest)
    return
}

// 使用解析后的数据
fmt.Printf("收到用户: %+v\n", user)

简化方式：直接解码
你也可以使用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,
    }
<pre class="brush:php;toolbar:false;">w.Header().Set("Content-Type", "application/json")
if err := json.NewEncoder(w).Encode(user); err != nil {
    http.Error(w, "生成JSON失败", http.StatusInternalServerError)
}

说明：
- 设置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服务需求。关键在于正确使用结构体标签、错误处理和内容类型设置。

今天关于《GolangJSON请求响应处理全解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于golang,JSON的内容请关注golang学习网公众号！