r.FormValue("username")返回空字符串主因是未调或晚调r.ParseForm()，因Go不自动解析表单；常见坑包括：提前读取r.Body致解析为空、GET请求误用r.PostFormValue()、multipart表单未调r.ParseMultipartForm()。
为什么 r.FormValue("username") 有时返回空字符串
不是字段没传，而是 r.ParseForm() 没调，或调得太晚。Go 不会自动解析表单体——它只在你第一次访问 r.Form、r.PostForm 或调用 r.FormValue() 时才隐式触发解析，但前提是请求方法支持（如 POST）、Content-Type 合法，且请求体尚未被读取过。
常见踩坑点：
- 提前调了
io.ReadAll(r.Body)或r.Body.Read()→ 请求体被消费完，ParseForm再读就为空 - 用
GET请求却调r.PostFormValue()→ 永远返回空，因为该方法只看 POST/PUT 的 body - 表单是
multipart/form-data（含文件），但只调r.ParseForm()没调r.ParseMultipartForm(32 → 文本字段都可能丢失 - 字段名大小写不一致，比如前端发
userName，后端取username→ 返回空
ParseForm 和 ParseMultipartForm 到底该用哪个
看 Content-Type 头：如果请求头是 application/x-www-form-urlencoded（标准表单），用 r.ParseForm() 就够了；如果是 multipart/form-data（带文件或富文本字段），必须用 r.ParseMultipartForm(maxMemory)。
maxMemory 建议设为 32 （32MB）：太小会导致小文件也写磁盘，太大可能 OOM；不设则默认仅 32KB，上传稍大文件就直接失败。
立即学习“go语言免费学习笔记（深入）”；
关键区别：
-
r.ParseForm()解析后，文本字段进r.PostForm，r.MultipartForm仍为nil -
r.ParseMultipartForm()解析后，文本字段进r.MultipartForm.Value，文件进r.MultipartForm.File，r.PostForm可能为空（取决于实现） - 两者不能混用顺序：先调
ParseMultipartForm，再读r.MultipartForm.Value["name"]；别指望ParseForm()能帮你从 multipart 里捞出字段
r.Form、r.PostForm、r.FormValue 三者怎么选
语义优先，别图省事全用 r.FormValue()。
r.Form 是 map[string][]string，包含 URL 查询参数 + POST 表单字段（同名时 POST 覆盖 GET）；r.PostForm 只含 POST body 中的字段，不含 URL 参数；r.FormValue("key") 是快捷方式，内部自动调 ParseForm() 并取 r.Form["key"][0]（若存在）。
推荐场景：
- 登录、注册等纯 POST 接口 → 用
r.PostFormValue("username")，避免攻击者通过?username=admin绕过校验 - 搜索页带分页参数（GET 提交）→ 用
r.FormValue("q")，自然兼容 URL 参数 - 要批量处理所有字段（比如日志记录、通用校验）→ 遍历
r.PostForm，而不是靠一堆FormValue调用 - 字段允许多值（如复选框
hobby=reading&hobby=coding）→ 别用FormValue，直接读r.PostForm["hobby"]切片
嵌套字段（如 user[0].name）怎么解析
Go 标准库不识别 [0]、. 这类语法，r.PostForm 里存的是扁平键名："user[0].name"、"user[0].age"、"user[1].name"……不会自动聚合成数组结构。
必须手动匹配、分组、重组。核心步骤：
- 先调
r.ParseForm()或r.ParseMultipartForm() - 遍历
r.PostForm的所有 key，用正则提取索引和子字段名，例如^user\[(\d+)\]\.(\w+)$ - 按索引归组，构建
map[int]map[string]string或对应 struct 切片 - 注意边界：索引可能不连续（
[0]、[2]跳过[1]），字段名可能含特殊字符，需严格校验
别试图用反射或第三方库“自动解构”——Go 的设计哲学是显式优于隐式，这种场景手写几行正则+循环更可靠、更易调试。
