本文详解如何使用 Go 的 json.NewDecoder 正确解析前端通过 fetch 发送的 JSON 格式 POST 请求体，重点解决结构体字段映射失败导致解析为空的问题。
本文详解如何使用 go 的 `json.newdecoder` 正确解析前端通过 `fetch` 发送的 json 格式 post 请求体，重点解决结构体字段映射失败导致解析为空的问题。
在 Go Web 开发中，接收并解析 JSON 格式的 POST 请求是常见需求。但若服务端结构体定义与客户端发送的 JSON 字段不匹配，json.Decoder 将无法完成反序列化——这正是你遇到 creds.Test 打印为空的根本原因。
你的前端代码使用 fetch 发送如下 JSON：
{
"email": "user@example.com",
"password": "123456"
}
而服务端结构体却定义为：
type credentials struct {
Test string // ❌ 无对应 JSON 字段，始终为空
}
由于 JSON 中不存在 "Test" 字段，Go 的 json 包不会填充该字段（也不会报错），导致 creds.Test 值为空字符串。
✅ 正确做法是：让 Go 结构体字段名与 JSON 键名逻辑一致，并通过 struct tag 显式声明映射关系。推荐写法如下：
type Credentials struct {
Email string `json:"email"`
Password string `json:"password"`
}
func Validate(rw http.ResponseWriter, req *http.Request, _ httprouter.Params) {
// 确保读取 Body 前未被其他中间件消耗（如已调用 req.ParseForm() 则需重置）
defer req.Body.Close() // ⚠️ 必须关闭，避免资源泄漏
decoder := json.NewDecoder(req.Body)
var creds Credentials
if err := decoder.Decode(&creds); err != nil {
http.Error(rw, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
fmt.Printf("Received email: %s, password: %s\n", creds.Email, creds.Password)
// ✅ 输出预期值，如：Received email: user@example.com, password: 123456
}
? 关键要点说明：
-
Struct tags 是必需的：Go 的
json包默认只导出首字母大写的字段（即公共字段），且严格按 tag 名（如json:"email"）匹配 JSON 键。没有 tag 时，会尝试匹配字段名（如Email→"email"），但因大小写不一致而失败。 -
字段必须导出（首字母大写）：小写字段（如
email string）无法被json包访问，永远无法解码。 -
务必关闭
req.Body：json.NewDecoder不自动关闭流，需手动defer req.Body.Close()防止连接泄漏。 -
错误处理要健壮：避免
panic(err)，应返回 HTTP 错误响应（如400 Bad Request）并记录日志，提升服务稳定性。
? 进阶提示：若需兼容不同命名风格（如 snake_case 或 camelCase），可统一使用 tag；也可借助 json.RawMessage 延迟解析嵌套或动态字段。
遵循以上规范，即可稳定、安全、清晰地完成 JSON POST 请求的解析任务。
