在 Go 的 net/http 中，若先调用 ioutil.ReadAll(r.Body)（或 io.ReadAll），会导致后续 r.ParseForm() 无法获取表单数据，因为 r.Body 是单次读取的 io.ReadCloser，读取后即耗尽，ParseForm 将解析空内容，最终 r.Form 为空。
在 go 的 `net/http` 中，若先调用 `ioutil.readall(r.body)`（或 `io.readall`），会导致后续 `r.parseform()` 无法获取表单数据，因为 `r.body` 是单次读取的 `io.readcloser`，读取后即耗尽，`parseform` 将解析空内容，最终 `r.form` 为空。
这是 Go Web 开发中一个高频且隐蔽的陷阱：http.Request.Body 只能被读取一次。它本质上是一个底层字节流（如 TCP 连接缓冲区），一旦被 ReadAll、json.Decoder.Decode 或其他 I/O 操作消费完毕，其内部指针即到达 EOF；而 r.ParseForm() 内部仍需从 r.Body 重新读取原始请求体来解析 application/x-www-form-urlencoded 或 multipart/form-data 数据——此时已无可用内容，故 r.Form 保持空映射。
✅ 正确做法：避免提前读取 Body
func loginHandler(w http.ResponseWriter, r *http.Request) {
log.Println("loginHandler")
log.Println("request method:", r.Method)
if r.Method == "POST" {
// ✅ 关键：不要提前读取 r.Body！
// r.ParseForm() 会自动按 Content-Type 解析表单数据
if err := r.ParseForm(); err != nil {
http.Error(w, "Failed to parse form", http.StatusBadRequest)
return
}
username := r.FormValue("username") // 推荐：更安全的单值获取
password := r.FormValue("password")
log.Printf("Parsed username: %q, password: %q", username, password)
// 注意：生产环境切勿打印明文密码，此处仅用于调试
// 后续业务逻辑...
us, err := globalSessions.SessionStart(w, r)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
http.Redirect(w, r, "/auth", http.StatusFound)
return
}
outputHTML(w, r, "static/login.html")
}
? 提示：优先使用
r.FormValue(key)而非r.Form[key]。前者返回第一个匹配值（自动解码 URL 编码），后者返回[]string切片，且当 key 不存在时返回nil切片（非空），易引发误判。
⚠️ 其他注意事项
-
Content-Type 必须匹配：
r.ParseForm()仅对application/x-www-form-urlencoded和multipart/form-data生效。若前端发送的是application/json，应改用json.NewDecoder(r.Body).Decode(&struct{})，并跳过ParseForm()。 -
Multipart 表单需额外处理：含文件上传时，
r.ParseMultipartForm()应在r.ParseForm()前调用（或直接调用前者，它会自动包含普通字段）。 -
Go 1.16+ 已弃用
ioutil：请使用io.ReadAll替代ioutil.ReadAll，并确保仅在必要时（如调试、日志、自定义中间件）读取 Body，且读取后需重置：body, _ := io.ReadAll(r.Body) r.Body = io.NopCloser(bytes.NewReader(body)) // 重置 Body 供后续使用（谨慎！）
? 快速诊断技巧
添加一行日志验证解析状态：
log.Printf("Form keys: %v, Error after ParseForm: %v",
maps.Keys(r.Form), r.ParseForm())
若输出 Form keys: [] 且无错误，大概率是 Body 已被提前消费。
总之，牢记 r.Body 的一次性语义——它是流，不是缓存。将 ParseForm() 置于逻辑起点，避免任何前置读取操作，即可彻底规避 r.Form 为空的问题。
