Go 的 http.Request 不自动解析表单，须显式调用 ParseForm() 或 ParseMultipartForm()；否则 r.Form 和 r.PostForm 为空；r.FormValue("username") 失效即因未调用解析方法；ParseForm() 适用于普通表单，ParseMultipartForm(maxMemory) 用于含文件上传的表单。
Go 的 http.Request 本身不自动解析表单，必须显式调用 ParseForm() 或 ParseMultipartForm()，否则 r.Form 和 r.PostForm 均为空 map。
必须先调用 ParseForm() 才能读取表单字段
很多新手在 handler 中直接访问 r.FormValue("username") 却得不到值，根本原因是没触发解析。Go 不会在请求初始化时自动解析表单（避免对非表单请求做无用解析）。
-
ParseForm()适用于application/x-www-form-urlencoded和无文件的纯表单 -
ParseMultipartForm(maxMemory)必须用于含type="file"的表单，且需提前指定内存上限（如32 表示 32MB） - 若已调用
ParseMultipartForm()，再调用ParseForm()会静默失败（不报错但不生效） - 重复调用任一解析方法不会 panic，但仅首次有效
r.FormValue() 与 r.PostFormValue() 的区别
二者都返回字符串，但来源不同，选错会导致逻辑错误：
-
r.FormValue("name")同时检查 URL 查询参数（?name=alice）和 POST 表单体（name=alice），按「查询参数优先」合并 —— 这是默认行为，适合通用字段读取 -
r.PostFormValue("name")仅从 POST body 解析，忽略 URL 查询参数 —— 适合严格区分 GET/POST 场景（如防止通过 URL 注入覆盖 POST 提交值） - 如果表单是 GET 请求（
method="get"），r.PostForm永远为空，只能用r.FormValue()
验证空值、类型转换与常见陷阱
Go 表单解析后所有值都是字符串，业务层必须自行验证和转换，没有内置校验器。
立即学习“go语言免费学习笔记（深入）”；
-
r.FormValue("age")返回空字符串""表示字段缺失或为空，不是nil—— 别用== nil判断 - 数字转换推荐用
strconv.Atoi()或strconv.ParseInt(..., 10, 64)，注意捕获err != nil（如用户输字母） - 布尔字段（如 checkbox）：HTML 中未勾选的 checkbox 不会发送任何值，所以
r.FormValue("agree") == ""表示未勾选；勾选时值为"on"或自定义value属性值（如） - 多值字段（如
或同名多个）：用r.Form["key"]获取[]string，而非FormValue
func loginHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
// 必须先解析，否则 FormValue 返回空字符串
if err := r.ParseForm(); err != nil {
http.Error(w, "Invalid form data", http.StatusBadRequest)
return
}
username := r.FormValue("username")
password := r.FormValue("password")
ageStr := r.FormValue("age")
if username == "" || password == "" {
http.Error(w, "Username and password required", http.StatusBadRequest)
return
}
age, err := strconv.Atoi(ageStr)
if err != nil || age < 0 || age > 150 {
http.Error(w, "Invalid age", http.StatusBadRequest)
return
}
// 处理成功...
}
最易被忽略的一点：当使用 curl -X POST -d "a=1&b=2" ... 测试时，Content-Type 默认是 application/x-www-form-urlencoded，此时 ParseForm() 有效；但如果用 curl -H "Content-Type: application/json" -d '{"a":1}' ...，则 ParseForm() 完全无效 —— Go 不会尝试解析 JSON 为表单，必须手动 json.Decode。表单解析和 JSON 解析是两条完全独立的路径。
