如何使用Golang处理JSON请求_使用json.Unmarshal解析客户端数据_技术教程

Go Web中JSON解析需三步：读取请求体（用io.ReadAll避免Body重复读）、定义导出结构体（配合json标签）、调用json.Unmarshal并严格检查err。

在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"})
}