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格式非法、缺少必需字段等。错误信息通常很明确，要立刻返回给客户端：
立即学习“go语言免费学习笔记（深入）”；
- 用
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——这三处出错，八成解析失败还找不到原因。
