必须先调用 r.ParseForm()（普通表单）或 r.ParseMultipartForm(32 << 20)（含文件上传），否则 r.PostFormValue("username") 等方法返回空字符串。
如何用 ParseForm 正确读取 POST 表单数据
Go 的 http.Request 不会自动解析表单，必须显式调用 ParseForm 或 ParseMultipartForm，否则 r.Form、r.PostForm 都是空的。这个步骤常被跳过，导致取不到值。
常见错误现象：r.PostFormValue("username") 始终返回空字符串，但浏览器开发者工具确认表单已提交。
- 必须在读取表单前调用
r.ParseForm()（适用于application/x-www-form-urlencoded） - 如果表单含文件上传（
<input type="file">），改用r.ParseMultipartForm(32 ，参数是最大内存缓存（如 32MB） -
ParseForm只能调用一次；重复调用会返回error: multipart: Part.Read: EOF - GET 请求的查询参数也会被解析进
r.Form，但r.PostForm仅包含 POST 数据
为什么 PostFormValue 和 FormValue 行为不同
FormValue 合并了 URL 查询参数和 POST 表单，而 PostFormValue 仅从 POST body 解析——这在 REST API 或混合提交场景中容易误用。
使用场景举例：一个搜索页面同时支持 GET 参数（/search?q=go）和 POST 表单（登录后提交筛选条件），若统一用 FormValue，可能意外覆盖或混淆来源。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 只处理纯 POST 表单时，优先用
r.PostFormValue("field")，语义明确 - 需要兼容 GET+POST（如分页表单回传）才用
r.FormValue("field") - 两者都返回
string，若字段未提交则为空字符串，**不会 panic**，但需业务层校验非空 - 若字段有多个同名值（如多选框
<select multiple>），用r.PostForm["field"]获取[]string
如何安全地绑定结构体并验证表单字段
Go 标准库不提供自动绑定，直接用 PostFormValue 拼结构体易出错且难维护。推荐手动映射 + 显式校验，避免引入重型框架带来的隐式行为。
性能与可读性权衡：反射绑定（如 gorilla/schema）在简单表单中反而增加复杂度，且错误堆栈不直观。
- 定义结构体时用 struct tag 标注字段名：
Username string `form:"username"` - 手动赋值并校验：
u := User{} u.Username = r.PostFormValue("username") if u.Username == "" { http.Error(w, "username is required", http.StatusBadRequest) return } - 对数字字段，用
strconv.Atoi或strconv.ParseInt转换，**别依赖PostFormValue返回类型**（它永远是 string） - 敏感字段（如密码）建议立即清空原始值：
defer func() { r.PostForm.Del("password") }()
常见 Content-Type 错误与调试技巧
前端发错 Content-Type 是表单取不到值的头号原因。浏览器原生 <form> 默认发 application/x-www-form-urlencoded，但 JS fetch 或 axios 默认发 text/plain 或 application/json，Go 后端完全无法识别。
错误信息示例：http: no such file（实际是 ParseForm 失败后继续访问 r.PostForm 导致 panic）或静默返回空值。
- 检查请求头：
curl -X POST -d "name=alice" http://localhost:8080/login默认带正确 header；但curl -H "Content-Type: application/json" -d '{"name":"alice"}' ...就不行 - 前端用
fetch提交表单时，必须显式设置：headers: { 'Content-Type': 'application/x-www-form-urlencoded' }，并用URLSearchParams序列化 - 调试时加一行日志：
log.Printf("Content-Type: %s, Method: %s, Body: %v", r.Header.Get("Content-Type"), r.Method, r.PostForm) - 如果必须支持 JSON 提交，就别用
ParseForm，改用json.Decoder解析r.Body
最易忽略的是：开发时用 HTML 表单测试正常，上线后前端换成 AJAX 却忘了改 Content-Type 和数据格式——这类问题不会报错，只会让后端“收不到数据”，排查时务必先抓包看真实请求头和 payload。
