必须调用c.FormFile获取文件元信息，否则c.PostForm仅返回空字符串；需用fileHeader.Open()获取io.ReadCloser并defer关闭；注意32MB内存阈值及TMPDIR配置。
用 c.FormFile 获取上传的文件元信息
Gin 不会自动解析 multipart 文件上传，必须显式调用 c.FormFile 才能拿到文件句柄和基本信息。如果跳过这步直接读 c.PostForm，只会得到空字符串或字段名，根本拿不到文件内容。
常见错误是误以为 c.PostForm("file") 能返回文件内容 —— 实际它只返回文本字段值，对文件字段永远为空。
-
c.FormFile("file")返回*multipart.FileHeader，含Filename、Size、Header等信息 - 字段名（如
"file"）必须和前端<input type="file" name="file">的name属性严格一致 - 若前端用数组形式上传（如
name="files[]"），需用c.MultipartForm()配合循环处理
用 fileHeader.Open() 读取文件流
拿到 *multipart.FileHeader 后，不能直接读内容，必须先调用 .Open() 得到 multipart.File（本质是 io.ReadCloser）。漏掉这步或忘记 defer file.Close() 会导致句柄泄漏、后续请求卡死。
示例中常有人把 fileHeader.Open() 和 os.Open() 混淆 —— 前者是内存/临时磁盘流，后者是本地文件系统路径，完全不互通。
- 调用
file, err := fileHeader.Open()后务必检查err，上传中断或格式异常时会返回非 nil 错误 - 读取完成后必须
defer file.Close()，否则连接无法释放，Gin 服务在高并发下会快速耗尽 fd - 若只需校验或小文件内容，可用
io.ReadAll(file)；大文件建议用io.Copy流式处理，避免内存暴涨
注意 Gin 默认的内存限制和临时目录
Gin 底层用 Go 标准库的 mime/multipart，默认将小于 32MB 的文件全部加载进内存，超过则写入临时磁盘。这个阈值由 c.Request.MultipartReader 的配置决定，但 Gin 没暴露直接修改入口，只能通过 c.Request.ParseMultipartForm 提前设置。
更隐蔽的问题是：若服务器没配 TMPDIR 或磁盘满，fileHeader.Open() 会静默失败并返回 nil 文件句柄 —— 此时再调 Read 就 panic。
- 启动时加
os.Setenv("TMPDIR", "/path/to/writable")确保临时目录可写 - 上传前用
c.Request.ParseMultipartForm(32 显式设上限（单位字节），避免 OOM - 生产环境务必检查
fileHeader.Size是否超出业务允许范围，别依赖前端传的Content-Length
完整可运行的读取逻辑片段
下面是最简但安全的文件内容读取写法，覆盖了打开、读、关、错处理四个关键点：
fileHeader, err := c.FormFile("file")
if err != nil {
c.JSON(400, gin.H{"error": "no file uploaded or parse error"})
return
}
file, err := fileHeader.Open()
if err != nil {
c.JSON(500, gin.H{"error": "failed to open file"})
return
}
defer file.Close()
content, err := io.ReadAll(file)
if err != nil {
c.JSON(500, gin.H{"error": "failed to read file content"})
return
}
// content 是 []byte，可做校验、解析、存库等
真正容易出问题的不是语法，而是临时目录权限、内存限制、以及忘记 defer file.Close() —— 这三点在线上压测时才暴露，但修复成本远高于写代码时多加两行。
