Go 的 json.Decoder 仅能解析 application/json 类型请求体，而浏览器原生表单提交默认使用 application/x-www-form-urlencoded 格式，需改用 r.FormValue() 或 r.ParseForm() 解析。
go 的 `json.decoder` 仅能解析 `application/json` 类型请求体，而浏览器原生表单提交默认使用 `application/x-www-form-urlencoded` 格式，需改用 `r.formvalue()` 或 `r.parseform()` 解析。
在 Go Web 开发中，一个常见误区是：试图用 json.NewDecoder(r.Body).Decode() 统一处理所有 POST 请求。这在调用 curl 或 httpie 发送 JSON 数据时看似正常，但在浏览器提交 <form> 或 jQuery .serialize() 时却静默失败（字段全为空），根本原因在于 HTTP 请求体格式与 Content-Type 不匹配。
从日志可清晰看出差异：
- curl/httpie 请求头含 Content-Type: application/json，Go 能正确反序列化；
- 浏览器表单提交的请求头为 Content-Type: application/x-www-form-urlencoded，此时 r.Body 是 URL 编码字符串（如 username=cesco&email=test%40example.com&password=123），json.Decoder 无法识别，直接跳过赋值，导致结构体字段保持零值（空字符串）。
✅ 正确做法：根据 Content-Type 动态选择解析方式：
func Register(w http.ResponseWriter, r *http.Request, p httprouter.Params) {
// 必须先调用 ParseForm（对 POST/PUT 等方法必需）
if err := r.ParseForm(); err != nil {
http.Error(w, "Invalid form data", http.StatusBadRequest)
return
}
// 方式 1：直接按键名取值（推荐用于简单表单）
username := r.FormValue("username")
email := r.FormValue("email")
password := r.FormValue("password")
log.Printf("Username: %s, Email: %s, Password: %s", username, email, password)
// 方式 2：若需强类型校验，可手动构造结构体
member := Member{
Username: username,
Email: email,
Password: password,
}
w.WriteHeader(http.StatusNoContent)
}⚠️ 注意事项：
- r.ParseForm() 是关键前置步骤——它会解析 application/x-www-form-urlencoded 和 multipart/form-data 请求体，并填充 r.PostForm 和 r.Form 映射。不调用则 FormValue 始终返回空字符串。
- 若前端需发送 JSON（例如 AJAX），必须显式设置请求头并发送 JSON 字符串：
// 前端示例：发送标准 JSON const data = { username: "cesco", email: "test@example.com", password: "123" }; fetch("/register", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(data) });后端此时才可安全使用 json.NewDecoder(r.Body).Decode(&t)。
? 总结：
Go 不像某些框架自动“猜测”请求格式。开发者必须明确区分数据来源：
- application/json → json.Decoder
- application/x-www-form-urlencoded / multipart/form-data → r.ParseForm() + r.FormValue()
混用将导致静默失败。建议在生产代码中增加 Content-Type 判断逻辑，或统一前后端约定（推荐全站采用 JSON API 风格），避免歧义。
