Golang处理JSON请求响应实战教程

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Golang处理JSON请求与响应实战》，这篇文章主要讲到等等知识，如果你对Golang相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

Go语言通过encoding/json包实现JSON解析与生成，定义结构体时使用json标签映射字段，如UserName string json:"user_name"；处理HTTP请求时用json.NewDecoder(r.Body).Decode(&req)解析JSON到结构体，需校验请求方法和Content-Type；返回响应时用json.NewEncoder(w).Encode(data)输出JSON，设置Content-Type为application/json；可使用map[string]interface{}处理动态JSON，但性能较低；推荐封装通用响应函数并注意零值、omitempty及错误处理，确保服务稳定。

在Go语言开发中，处理JSON数据是Web服务最常见的任务之一。无论是接收客户端传来的JSON请求体，还是返回结构化的JSON响应，Golang都提供了简洁高效的内置支持。通过 encoding/json 包，你可以轻松完成JSON的解析（反序列化）与生成（序列化）。

定义结构体映射JSON

要正确解析或生成JSON，第一步是定义与JSON格式匹配的Go结构体。结构体字段需以大写字母开头，并通过 json标签 控制键名映射。

// 请求示例：{ "user_name": "alice", "age": 25 }
type UserRequest struct {
    UserName string `json:"user_name"`
    Age      int    `json:"age"`
}

// 响应示例：{ "success": true, "message": "ok" }
type Response struct {
    Success bool   `json:"success"`
    Message string `json:"message"`
}

解析JSON请求体

在HTTP处理器中，使用 json.NewDecoder 从请求体读取并解析JSON数据到结构体。

func handleLogin(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
        return
    }

    var req UserRequest
    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }
    // 处理逻辑...
}

• 确保检查请求方法和Content-Type头
• 解码失败时返回400错误，便于前端调试
• 及时关闭r.Body（通常由框架自动处理）

返回JSON响应

使用 json.NewEncoder 将结构体编码为JSON并写入响应流。

func sendResponse(w http.ResponseWriter, data interface{}) {
    w.Header().Set("Content-Type", "application/json")
    if err := json.NewEncoder(w).Encode(data); err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

// 在处理器中调用
sendResponse(w, Response{
    Success: true,
    Message: "login successful",
})

• 设置正确的Content-Type防止前端解析错误
• 结构体字段为零值时也会被输出，可用指针或omitempty控制
• 推荐封装通用响应函数提升代码复用性

处理动态或未知结构

当无法预定义结构体时，可使用 map[string]interface{} 或 interface{} 接收任意JSON对象。

var raw map[string]interface{}
json.NewDecoder(r.Body).Decode(&raw)
name := raw["user_name"].(string)

• 类型断言需谨慎，建议配合ok判断避免panic
• 适用于配置解析、Webhook等场景
• 性能低于结构体，不推荐高频接口使用

基本上就这些。掌握结构体标签、NewDecoder/Encoder的使用，以及常见边界处理，就能在Golang项目中高效应对大多数JSON场景。不复杂但容易忽略的是错误处理和Header设置，保持严谨才能构建稳定服务。

好了，本文到此结束，带大家了解了《Golang处理JSON请求响应实战教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！