结构体绑定对文件无效，因为gin的shouldbind等方法仅解析请求体中的键值数据（如json或表单url编码），而multipart/form-data中的文件被封装在独立字段中，不在原始body可解码位置；必须用c.formfile("field_name")获取fileheader，再open()读取内容并defer关闭。
不能直接用结构体绑定接收上传文件——c.ShouldBind 和 c.ShouldBindJSON 等方法完全不处理 multipart/form-data 中的文件字段，强行调用会返回 invalid character ' 或空文件错误。
为什么结构体绑定对文件无效
Gin 的结构体绑定（如 ShouldBind）只解析请求体（c.Request.Body）中的键值数据，比如 application/x-www-form-urlencoded 或 application/json。而文件上传必须走 multipart/form-data 编码，文件内容被封装在独立的表单字段里，不是普通键值对，更不在原始 body 中可直接解码的位置。
常见误操作包括：
- 定义结构体字段带
form:"file"标签，然后c.ShouldBind(&v)—— 绑定成功但v.File为空 - 把
Content-Type: application/json和--form "file=@xxx"混用 —— curl 自动设的multipartboundary 被覆盖，Gin 解析失败 - 在调用
c.FormFile()前读过c.Request.Body（比如 log 或中间件）—— body 已被消费，后续FormFile返回nil
c.FormFile 是唯一可靠入口
所有文件上传逻辑必须从 c.FormFile("field_name") 开始，它返回 *multipart.FileHeader，这才是 Gin 提供的、专为文件设计的解析入口。
关键点：
-
field_name必须和 HTML 表单<input type="file" name="avatar">或 curl--form "avatar=@photo.jpg"中的 key 完全一致 -
FileHeader不是文件内容，只是元信息（Filename、Size、Header），要读内容得调fileHeader.Open() -
Open()返回multipart.File（实际是io.ReadCloser），必须defer file.Close() - 上传大小限制需提前设：
r.MaxMultipartMemory = 10 ，否则超限会静默截断
XML 文件上传：先 FormFile，再 xml.NewDecoder
如果上传的是 XML 文件（例如配置文件），不能用 c.ShouldBindXML，它只处理裸 XML 请求体，不处理表单里的文件字段。
正确路径是：
- 用
c.FormFile("config")获取*multipart.FileHeader -
file, err := header.Open()得到可读流 -
err := xml.NewDecoder(file).Decode(&v)流式解析（推荐）；或bytes, _ := io.ReadAll(file); xml.Unmarshal(bytes, &v)（仅适合小文件） - 注意：XML 编码声明（如
<?xml version="1.0" encoding="UTF-16"?>）会被xml.NewDecoder自动识别，Unmarshal则要求输入必须是 UTF-8
最易被忽略的一点：文件句柄未关闭会导致 fd 耗尽，服务逐渐拒绝新连接；而 c.FormFile 返回的 FileHeader 本身不占 fd，只有 Open() 后才打开，所以 defer file.Close() 不是可选项，是必选项。
