首页 > Golang > Go教程

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

时间：2026-01-22 14:29:51 227浏览收藏

欢迎各位小伙伴来到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及错误处理，确保服务稳定。

Golang如何处理JSON请求与响应_Golang JSON解析与序列化实战

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

定义结构体映射JSON

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

<span style="color:#008000;">// 请求示例：{ "user_name": "alice", "age": 25 }</span>
<span style="color:#0000ff;">type</span> UserRequest <span style="color:#0000ff;">struct</span> {
    UserName <span style="color:#0000ff;">string</span> `json:<span style="color:#a31515;">"user_name"</span>`
    Age      <span style="color:#0000ff;">int</span>    `json:<span style="color:#a31515;">"age"</span>`
}

<span style="color:#008000;">// 响应示例：{ "success": true, "message": "ok" }</span>
<span style="color:#0000ff;">type</span> Response <span style="color:#0000ff;">struct</span> {
    Success <span style="color:#0000ff;">bool</span>   `json:<span style="color:#a31515;">"success"</span>`
    Message <span style="color:#0000ff;">string</span> `json:<span style="color:#a31515;">"message"</span>`
}

解析JSON请求体

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

<span style="color:#0000ff;">func</span> handleLogin(w http.ResponseWriter, r *http.Request) {
    <span style="color:#0000ff;">if</span> r.Method != <span style="color:#a31515;">"POST"</span> {
        http.Error(w, <span style="color:#a31515;">"method not allowed"</span>, http.StatusMethodNotAllowed)
        <span style="color:#0000ff;">return</span>
    }

    <span style="color:#0000ff;">var</span> req UserRequest
    <span style="color:#0000ff;">if</span> err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        <span style="color:#0000ff;">return</span>
    }
    <span style="color:#008000;">// 处理逻辑...</span>
}

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

返回JSON响应

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

<span style="color:#0000ff;">func</span> sendResponse(w http.ResponseWriter, data <span style="color:#0000ff;">interface</span>{}) {
    w.Header().Set(<span style="color:#a31515;">"Content-Type"</span>, <span style="color:#a31515;">"application/json"</span>)
    <span style="color:#0000ff;">if</span> err := json.NewEncoder(w).Encode(data); err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

<span style="color:#008000;">// 在处理器中调用</span>
sendResponse(w, Response{
    Success: <span style="color:#0000ff;">true</span>,
    Message: <span style="color:#a31515;">"login successful"</span>,
})

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

处理动态或未知结构

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

<span style="color:#0000ff;">var</span> raw map[string]<span style="color:#0000ff;">interface</span>{}
json.NewDecoder(r.Body).Decode(&raw)
name := raw[<span style="color:#a31515;">"user_name"</span>].(<span style="color:#0000ff;">string</span>)

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

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

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

前往漫画官网入口并下载 ➜

golang JSON