c.postform() 必须在 c.formfile() 之前调用，否则因 request.body 已被消费而返回空；正确顺序是先用 c.postform* 获取所有文本字段，再用 c.formfile 或 c.multipartform() 读文件。
c.FormFile() 和 c.PostForm() 可以共存，但必须按顺序调用：先取文件，再取表单字段；否则 c.PostForm() 会返回空字符串。
为什么 c.PostForm("name") 总是空？
根本原因是 Gin 的 c.FormFile() 内部会消费整个 c.Request.Body，而 c.PostForm() 依赖未被读取的原始 body。一旦你调用了 c.FormFile()（哪怕只调一次），后续再调 c.PostForm() 就拿不到值了——它不是“缓存失效”，而是 body 已经被关掉了。
常见错误现象：
-
前端传了
name=alice&file=@photo.jpg，后端却打印出c.PostForm("name") == "" - 没报错、没 panic，但所有文本字段都丢了
- 把
c.PostForm()放在c.FormFile()后面，还纳闷“为什么表单字段不生效”
正确做法是：所有 c.PostForm() 调用必须放在 c.FormFile() 之前。
如何安全地同时接收 file + text 字段？
必须严格遵循这个顺序：先读全部表单字段，再读文件。Gin 不提供“一次性读完所有内容”的原子方法，所以顺序就是契约。
实操建议：
- 用
c.PostForm("title")、c.DefaultPostForm("category", "other")等提前拿到所有文本参数 - 再用
c.FormFile("avatar")或c.MultipartForm()拿文件 - 如果字段名不确定，可用
c.Request.MultipartForm.Value手动遍历（但依然得在FormFile之前） - 不要试图在
FormFile后再调c.Request.PostFormValue—— 它底层和c.PostForm()是同一套逻辑，一样为空
示例片段：
func handleUpload(c *gin.Context) {
// ✅ 先读文本字段
title := c.PostForm("title")
desc := c.DefaultPostForm("description", "")
category := c.PostForm("category")
// ❌ 这里不能反过来：FormFile 必须在最后
file, err := c.FormFile("avatar")
if err != nil {
c.JSON(400, gin.H{"error": "no file provided"})
return
}
// 后续处理 title / desc / file...
}
curl 测试时容易漏掉的关键点
用 curl -F 发送混合数据时，-F 本身就能携带任意字段，不需要额外拼 query 或加 Content-Type: application/json —— 那样反而会破坏 multipart 结构。
典型错误：
-
curl -X POST -H "Content-Type: application/json" -F "file=@a.jpg" ...→ 直接 400，Gin 拒绝解析 -
curl -d "name=test" -F "file=@a.jpg"→-d和-F不能混用，curl 会静默忽略-d - 漏写
-F "name=value"，只传文件，导致后端c.PostForm("name")为空且无提示
✅ 正确命令：
curl -X POST http://localhost:8080/upload \ -F "title=My Photo" \ -F "description=Sunset at beach" \ -F "avatar=@/path/to/photo.jpg"
多文件 + 多文本字段的边界情况
当表单里有多个同名文件字段（如 <input type="file" name="photos" multiple>），前端实际发的是多个 photos key，此时 c.FormFile("photos") 只返回第一个，必须用 c.MultipartForm() 才能拿到全部。
但注意：c.MultipartForm() 同样会消费 body，所以它也必须放在所有 c.PostForm() 之后 —— 也就是说，如果你既要读全部文件又要读全部文本字段，唯一安全顺序是：
- 先
c.PostForm*系列取文本 - 再
c.MultipartForm()取文件和剩余字段（form.Value和form.File）
这时候 c.MultipartForm().Value["title"] 和 c.PostForm("title") 是等价的，但前者更重、更慢，没必要替代后者。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
