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——这三处出错,八成解析失败还找不到原因。
以上就是如何使用Golang处理JSON请求_使用json.Unmarshal解析客户端数据的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1428727.html
微信扫一扫
支付宝扫一扫