shouldbind对单文件上传不起作用，因其默认仅解析application/x-www-form-urlencoded和application/json，无法处理含二进制流的multipart/form-data；正确方式是用c.postform取文本字段、c.formfile取文件，并手动校验大小、类型等。
ShouldBind 为什么对单文件上传不起作用
因为 ShouldBind 默认只处理 application/x-www-form-urlencoded 和 application/json 这类结构化数据，而文件上传（multipart/form-data）的请求体里混着二进制流和文本字段，Gin 的绑定器无法自动解析出文件字段——它会直接跳过 file 字段，或报 Key: xxx not found 错误。
单文件表单必须用 PostForm + FormFile 分开取值
真实场景中，一个含文件的表单往往还带其他字段（如 title、desc），不能全靠结构体绑定。正确做法是手动分离：
-
c.PostForm("title")取普通文本字段 -
c.FormFile("avatar")取单个文件（返回*multipart.FileHeader） - 校验逻辑写在业务层：检查
file != nil、file.Size 、<code>strings.HasSuffix(file.Filename, ".png")等
示例：
func uploadHandler(c *gin.Context) {
title := c.PostForm("title")
file, err := c.FormFile("avatar")
if err != nil {
c.JSON(400, gin.H{"error": "缺少文件或格式错误"})
return
}
if file.Size > 5*1024*1024 {
c.JSON(400, gin.H{"error": "文件不能超过 5MB"})
return
}
// 保存文件...
c.JSON(200, gin.H{"title": title, "filename": file.Filename})
}
想用结构体绑定？得自己写 Custom Binding
Gin 原生不支持把 multipart/form-data 直接绑定到含 file 字段的结构体上。如果硬要结构体风格，必须实现 binding.Binding 接口：
- 定义结构体时，
file字段类型只能是*multipart.FileHeader，且不能加binding标签（校验无效） - 写一个自定义 binding，比如
formWithFileBinding，重写Bind()方法，先req.ParseMultipartForm()，再分别取PostForm和FormFile - 调用时用
c.ShouldBindWith(&form, formWithFileBinding{})
但多数项目没必要走这一步——手动取值更直观、可控，也更容易做 MIME 类型、大小、扩展名等细粒度校验。
容易被忽略的 Content-Type 和前端坑
浏览器表单默认发 multipart/form-data，但如果你用 axios 或 fetch 发送 FormData，没设 Content-Type，浏览器会自动加上带 boundary 的 header；可一旦手动设置了 Content-Type: multipart/form-data（没带 boundary），后端就收不到任何字段。
- ✅ 正确：让浏览器自动设置 header（不显式设
Content-Type） - ❌ 错误：
headers: {"Content-Type": "multipart/form-data"} - 后端调试时，用
c.Request.MultipartForm是否为nil判断是否成功解析
真正麻烦的不是绑定，而是边界条件：空文件、同名字段重复、恶意超大文件、伪造 extension。这些都得在 FormFile 之后手动挡，而不是依赖 binding 标签。
