Go 的 http.Request 默认不自动解析表单数据，需显式调用 r.ParseForm() 或 r.ParseMultipartForm() 才能使用 FormValue 等方法；前者适用于普通表单和查询参数，后者专用于文件上传，且会隐式调用 ParseForm()。
Go 的 http.Request 默认不自动解析表单数据
很多初学者以为调用 r.FormValue("key") 就能直接取到 POST 表单或 URL 查询参数，结果返回空字符串——根本原因是 Go 的 *http.Request 不会在你访问 Form、PostForm 或调用 FormValue 前自动解析请求体。必须显式触发解析，否则 r.Form 是 nil，r.PostForm 也是 nil。
正确做法是：在读取任何表单或查询参数前，先调用 r.ParseForm()（适用于 GET 和 POST application/x-www-form-urlencoded）或 r.ParseMultipartForm()（仅用于 multipart/form-data，如文件上传）。
-
r.ParseForm()会同时解析 URL 查询参数（r.URL.Query()）和请求体中的表单数据，并合并到r.Form和r.PostForm - 如果只调用
r.ParseMultipartForm()，它会隐式调用r.ParseForm()，但仅当 Content-Type 是multipart/form-data时才有效 - 对 JSON 请求体（
application/json），ParseForm()完全无效，必须用json.Decode(r.Body)手动解析
r.FormValue() 和 r.PostFormValue() 的区别与陷阱
r.FormValue("name") 从 r.Form 中取值，它会合并 URL 查询参数和请求体中的同名字段；而 r.PostFormValue("name") 只从 r.PostForm（即请求体部分）取值，忽略 URL 参数。两者都要求已调用过 ParseForm() 或 ParseMultipartForm()。
常见错误是混用场景：比如用 GET /api?user=id1 测试接口，却在代码里写 r.PostFormValue("user")，结果永远为空。
立即学习“go语言免费学习笔记（深入）”；
-
r.FormValue("x")：等价于r.Form["x"][0]（取第一个值），若 key 不存在则返回空字符串 -
r.PostFormValue("x")：等价于r.PostForm["x"][0]，只查请求体，不查 URL 查询串 - 若需获取所有同名参数值（如多选 checkbox），用
r.Form["x"]或r.PostForm["x"]，它们返回[]string - 注意：如果请求是
GET，r.PostForm始终为空；如果是POST且没调用ParseForm()，两者都为空
处理 multipart/form-data（含文件上传）的必要步骤
当 HTML 表单设置了 enctype="multipart/form-data"，或客户端发送了带文件的表单，必须用 r.ParseMultipartForm()，不能只靠 ParseForm()。否则 r.PostForm 为空，r.MultipartForm 也为 nil。
ParseMultipartForm(maxMemory int64) 的参数不是最大文件大小，而是内存中缓存的上限（单位字节）。超过该值的部分会暂存到磁盘临时文件。默认值是 32 （32MB），但如果你不显式调用，Go 不会自动解析 multipart 数据。
err := r.ParseMultipartForm(32 << 20)
if err != nil {
http.Error(w, "无法解析表单", http.StatusBadRequest)
return
}
// 现在可以安全读取普通字段
name := r.FormValue("name")
// 也可以读取文件
file, header, err := r.FormFile("avatar")
if err == nil {
defer file.Close()
// 处理上传的文件...
}
- 调用
r.ParseMultipartForm()后，r.Form和r.PostForm才包含普通字段值 -
r.FormFile("key")是快捷方式，等价于r.MultipartForm.File["key"][0]，只取第一个同名文件 - 如果没调用
ParseMultipartForm()就直接调用r.FormFile()，会返回http.ErrNotMultipart
URL 查询参数应优先用 r.URL.Query().Get("k")
虽然 r.FormValue("k") 也能读取 URL 查询参数，但它依赖 ParseForm()，而 r.URL.Query() 是原始解析（由 Go HTTP server 在接收请求时自动完成），无需额外调用，更轻量、更可靠。
尤其在中间件或早期请求处理阶段（比如鉴权、日志记录），你可能不想/不能触发完整的表单解析（例如担心恶意大请求体阻塞），这时直接读 r.URL.Query() 是安全的选择。
-
r.URL.Query().Get("page")：安全、无需 ParseForm、只读查询参数 -
r.URL.Query().Get("page")返回空字符串表示 key 不存在或值为空；用r.URL.Query()["page"]可获取所有值 - 注意：
r.URL.Query()不包含请求体内容，也不受ParseForm()影响 - 如果业务逻辑明确区分“查询参数”和“提交数据”，就不要用
FormValue混合读取，避免语义混淆
最常被忽略的一点：ParseForm() 是有副作用的——它会读取并缓冲整个请求体。如果后续你还想用 r.Body（比如解 JSON 或流式处理），必须在 ParseForm() 前完成，或者用 io.Copy + bytes.NewReader 重置 body。否则会读到 EOF。
