Golang解析JSON请求全攻略

在Go Web开发中，正确解析JSON请求看似简单，实则暗藏三大关键陷阱：HTTP请求体只能读取一次，必须用io.ReadAll预加载并复用；结构体字段需首字母大写导出，并通过json标签精准映射键名与类型（支持嵌套、指针、omitempty等）；而最易被忽视的是严格检查json.Unmarshal的错误——忽略err会导致静默失败，数据全为零值。掌握这三点，才能写出健壮、可维护、易调试的JSON处理逻辑。

在Go Web开发中，用 json.Unmarshal 解析客户端提交的JSON数据是最基础也最关键的一步。核心就三点：读取请求体、定义匹配结构体、调用 json.Unmarshal 解析。只要结构体字段名和JSON键对得上，且导出（首字母大写），就能顺利解析。

确保请求体可多次读取（避免body为空）

HTTP请求体（r.Body）是单次读取流，一旦被读过（比如日志中间件、鉴权逻辑提前读了），后续再调用 json.NewDecoder(r.Body).Decode(...) 就会得到空数据或错误。稳妥做法是先读到字节切片，再复用：

• 用 io.ReadAll(r.Body) 一次性读取全部内容
• 把读到的 []byte 同时用于解析、日志、校验等场景
• 如果必须用 json.Decoder（适合大JSON流），记得在中间件里用 http.MaxBytesReader 或 httputil.DumpRequest 等方式安全复制Body

定义结构体时注意字段标签和导出规则

Go结构体字段必须导出（首字母大写）才能被 json 包访问。JSON键名默认映射为字段名（大小写敏感），但更常用的是通过 json: 标签显式指定：

• Username string `json:"username"` → 匹配 JSON 中的 "username"
• CreatedAt time.Time `json:"created_at"` → 支持下划线命名转换
• IsActive *bool `json:"is_active,omitempty"` → 字段为空值时不参与序列化，反向解析时也允许缺失
• 嵌套对象、切片、指针都直接支持，无需额外处理

解析时务必检查错误，别忽略err

json.Unmarshal 失败很常见——字段类型不匹配、JSON格式非法、缺少必需字段等。错误信息通常很明确，要立刻返回给客户端：

• 用 if err != nil { http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest); return }
• 不要用 _ 忽略错误，否则程序看似运行，实际数据是零值（比如字符串为空、数字为0、布尔为false）
• 若需更友好的错误提示，可用第三方库如 go-jsonerror 或手动检查关键字段是否为零值

完整示例：一个标准的POST JSON处理函数

（假设接收 {"name":"Alice","age":30}）

type UserReq struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

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

    body, err := io.ReadAll(r.Body)
    if err != nil {
        http.Error(w, "Failed to read body", http.StatusBadRequest)
        return
    }

    var req UserReq
    if err := json.Unmarshal(body, &req); err != nil {
        http.Error(w, "Invalid JSON format: "+err.Error(), http.StatusBadRequest)
        return
    }

    // 此时 req.Name 和 req.Age 已正确填充
    log.Printf("Received user: %+v", req)
    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
}

基本上就这些。不复杂但容易忽略细节，比如Body重复读、结构体没导出、忘了检查err——这三处出错，八成解析失败还找不到原因。

今天关于《Golang解析JSON请求全攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！