Golang如何处理JSON请求与响应_Golang JSON解析与序列化实战-Golang-PHP中文网

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

P粉602998670

发布： 2025-12-02 18:26:40

原创

538人浏览过

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并写入响应流。

网易人工智能

网易数帆多媒体智能生产力平台

206

查看详情

立即学习“go语言免费学习笔记（深入）”；

<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>)

登录后复制