必须先调用 r.ParseForm() 解析普通表单，或 r.ParseMultipartForm(32 << 20) 解析含文件的表单，否则 r.PostFormValue 返回空；标准库不自动解析 POST 表单。
如何用 http.HandleFunc 正确接收 POST 表单数据
Go 的标准库不会自动解析 POST 表单，必须显式调用 r.ParseForm() 或 r.ParseMultipartForm()，否则 r.Form 和 r.PostForm 都是空的。
常见错误现象：直接读 r.PostFormValue("username") 返回空字符串，但浏览器开发者工具里确认已发送表单字段。
- 对普通
application/x-www-form-urlencoded表单，必须先调用r.ParseForm() - 对含文件上传的
multipart/form-data，应优先用r.ParseMultipartForm(32 （32MB 内存限制） - 若未调用解析函数就访问
r.PostForm，Go 会静默返回空值，不报错也不警告 -
r.FormValue("key")会同时检查 URL 查询参数和 POST 表单，而r.PostFormValue("key")只查 POST 部分，更安全
func loginHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
// 必须加这行！否则 PostFormValue 拿不到数据
if err := r.ParseForm(); err != nil {
http.Error(w, "Bad request", http.StatusBadRequest)
return
}
username := r.PostFormValue("username")
password := r.PostFormValue("password")
// ... 处理逻辑
}
为什么 r.ParseMultipartForm 要传最大内存参数
这个参数不是“最大文件大小”，而是 Go 在内存中缓存 multipart 数据的上限。超过该值，Go 会自动把剩余部分写入临时磁盘文件（由 os.TempDir() 决定），影响性能且可能填满磁盘。
- 传
0会导致所有 multipart 数据都落盘，完全绕过内存优化 - 传太小（如
1024）会让稍大点的文本字段也写磁盘，增加 I/O 开销 - 默认值是
32 （32MB），适合大多数含小图或文本的表单 - 如果只处理纯文本字段，
r.ParseForm()更轻量，无需设限
处理 JSON POST 请求时别误用 ParseForm
当前端用 fetch(..., { method: 'POST', body: JSON.stringify(...) }) 发送数据时，Content-Type 是 application/json，此时 r.ParseForm() 无效，甚至会返回错误。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
io.ReadAll(r.Body)读原始字节，再用json.Unmarshal解析 - 读完
r.Body后它就被关闭了，无法二次读取 —— 别在中间件和 handler 里重复读 - 若同时支持表单和 JSON，需根据
r.Header.Get("Content-Type")分支处理 - 注意：
r.Body是io.ReadCloser，读完记得defer r.Body.Close()（但通常 handler 结束即释放）
func apiUserHandler(w http.ResponseWriter, r *http.Request) {
if r.Header.Get("Content-Type") != "application/json" {
http.Error(w, "Content-Type must be application/json", http.StatusBadRequest)
return
}
defer r.Body.Close()
body, err := io.ReadAll(r.Body)
if err != nil {
http.Error(w, "Cannot read body", http.StatusBadRequest)
return
}
var u struct {
Name string `json:"name"`
Email string `json:"email"`
}
if err := json.Unmarshal(body, &u); err != nil {
http.Error(w, "Invalid JSON", http.StatusBadRequest)
return
}
// ... 处理 u.Name 和 u.Email
}
表单验证失败后如何保留用户已填内容
Go 没有内置表单回显机制，需要手动把原始值塞回 HTML 模板。关键点是：不能直接信任 r.PostFormValue 返回的值做输出，要转义防止 XSS。
- 用
html.EscapeString()处理所有用户输入后再插入 HTMLvalue属性 - 避免在模板里拼接字符串，改用
html/template的{{.Username}}自动转义 - 如果验证失败，用
http.Error会清空请求体；应重定向到 GET 页面或直接渲染带错误信息的表单 - 不要在 POST handler 里用
http.Redirect后继续执行，容易导致重复提交
真正麻烦的是边界情况：比如用户粘贴了换行符、超长字符串、或 UTF-8 BOM 字节 —— 这些都会让 ParseForm 静默失败或截断字段，得靠日志和 r.Body 原始读取来排查。
