r.ParseForm() 必须在读取 r.Body 之前调用,因为其解析依赖未耗尽的请求体流;一旦 r.Body 被读取,后续 ParseForm() 将失败且 r.Form 为空。
r.ParseForm() 必须在读取 r.Body 之前调用Go 的 http.Request 对表单数据的解析是惰性的,且有一次性约束:一旦你手动读取了 r.Body(比如用 io.ReadAll(r.Body)),r.Form 和 r.PostForm 就会变为空,后续再调用 r.ParseForm() 也拿不到值。
这是因为底层把 Body 当作流处理,读完就 EOF;而 ParseForm() 内部会尝试重新读取 Body 来解析表单,但此时已不可用。
r.ParseF
orm() → 再取 r.FormValue("key") 或 r.PostForm
io.ReadAll(r.Body) → 再 r.ParseForm() → 结果 r.Form 为空r.ParseMultipartForm() 配合 r.MultipartReader(),或提前用 bytes.Buffer 缓存r.FormValue() 和 r.PostFormValue() 的区别在哪r.FormValue("name") 会自动合并 URL 查询参数(?name=alice)和 POST 表单数据(application/x-www-form-urlencoded 或 multipart/form-data 中的字段),按 “POST 覆盖 GET” 规则返回第一个非空值。
r.PostFormValue("name") 只查 POST 部分,不看 URL 参数,更严格也更安全——尤其在 API 场景中避免 GET 参数被意外覆盖。
?id=123,没 body → r.FormValue("id") 返回 "123",r.PostFormValue("id") 返回空字符串id=456,URL 也有 ?id=123 → r.FormValue("id") 返回 "456",r.PostFormValue("id") 也是 "456"
r.URL.Query().Get("id") 和 r.PostFormValue("id")
r.ParseMultipartForm() 要设内存阈值Go 默认只把小文件(32 字节,即 32MB)留在内存里解析;超过的部分会写入临时磁盘文件。但这个阈值必须显式调用 r.ParseMultipartForm(maxMemory) 设置,否则遇到 multipart 请求会直接返回 http.ErrNotMultipart 错误。
注意:这个调用本身不触发解析,只是预设配置;真正解析发生在首次访问 r.MultipartForm 或 r.FormValue 等方法时。
r.ParseMultipartForm(32 放在 handler 开头
0,表示全部写磁盘(不推荐,影响性能)r.FormValue("file") 可能返回空,且 r.MultipartForm 为 nil,容易误判为“没传字段”context.WithTimeout 和流式处理(r.MultipartReader()),避免阻塞HTML 中多个 提交后,对应一个 key 多个 value。Go 不会自动合并成 slice,必须显式调用 r.Form["tag"] 或 r.PostForm["tag"] 获取 []string。
r.FormValue("tag") 只返回第一个匹配值,对多选场景完全不可用。
tags := r.PostForm["tag"] → 得到完整字符串切片if vals, ok := r.PostForm["tag"]; ok { ... }
r.PostForm["tag"] 仍是长度为 1 的 slice,不是单个 stringlen(r.FormValue("tag")) > 0 判断是否提交——它掩盖了多值语义r.FormValue() 依赖自动合并,一边又手动解析 r.URL.Query(),结果在边界 case(如 GET+POST 同 key)下行为不一致。保持数据源明确,比追求代码短更重要。