必须通过 c.FormFile() 或 c.MultipartForm() 获取文件句柄，因 Gin 默认已提前解析 multipart 表单导致 c.Request.Body 被消耗；c.FormFile("file") 返回 *multipart.FileHeader，调用其 Open() 方法才能获得可读 io.ReadCloser 并安全读取原始二进制流。
如何用 gin.Context 正确读取上传的二进制文件流
直接调用 c.Request.Body 会失败——Gin 默认已提前解析 multipart 表单，Request.Body 在文件上传场景下已被消耗，再次读取返回空。必须通过 c.FormFile() 或 c.MultipartForm() 获取文件句柄。
-
c.FormFile("file")最常用：返回*multipart.FileHeader，含文件名、大小、头信息；调用其Open()方法才得到可读的io.ReadCloser - 若需多个文件或额外表单字段，用
c.MultipartForm()，它返回完整*multipart.Form，.File字段是map[string][]*multipart.FileHeader - 注意：Gin 默认限制最大内存为 32MB（
gin.DefaultWriter无显式配置时），超限会自动写入临时磁盘；可通过gin.SetMode(gin.ReleaseMode)后手动设置MaxMultipartMemory调整
c.FormFile 返回的 *multipart.FileHeader 怎么读成原始字节
别直接 io.ReadAll(c.Request.Body)，那是错的。正确路径是先 Open() 得到文件句柄，再读取：
file, err := c.FormFile("data")
if err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": err.Error()})
return
}
src, err := file.Open()
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to open file"})
return
}
defer src.Close()
data, err := io.ReadAll(src) // 这才是真正的二进制流内容
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to read file"})
return
}
// data 就是 []byte 类型的原始二进制数据
-
file.Size可在Open()前检查，避免读取超大文件导致 OOM -
file.Header包含原始 MIME 类型（如application/pdf），可用于校验而非仅依赖扩展名 - 如果只是转发或透传，建议用
io.Copy(c.Writer, src)流式处理，不全量加载内存
接收 raw binary body（非 multipart）时怎么读
当客户端用 Content-Type: application/octet-stream 直接 POST 二进制数据（比如 curl -X POST --data-binary @xxx.bin），Gin 不会自动解析 multipart，此时才能安全使用 c.Request.Body：
- 务必设置
c.Request.ContentLength上限，防止恶意长 body 耗尽内存；可用中间件预检：if c.Request.ContentLength > 10*1024*1024 { c.AbortWithStatus(413); return } -
data, _ := io.ReadAll(c.Request.Body)可行，但生产环境建议带 context 和 timeout 控制：io.ReadFull(io.LimitReader(c.Request.Body, limit), buf) - Gin 默认不校验
Content-Type，若需强制匹配，加判断：if c.GetHeader("Content-Type") != "application/octet-stream" { ... }
常见错误：为什么 c.PostForm 拿不到文件？
c.PostForm("key") 只能读文本字段，永远拿不到文件内容——这是 HTTP 协议限制，文件必须走 multipart 的 Content-Disposition: form-data; name="file"; filename="x" 分隔块。混淆会导致返回空字符串或 panic。
立即学习“go语言免费学习笔记（深入）”；
- 前端必须用
FormData构造请求，不能把文件转 base64 后塞进普通表单字段（除非后端主动 base64 解码） - curl 示例要带
-F "file=@/path/to/file"，不是-d - Gin 日志里出现
http: no such file或multipart: NextPart: EOF，基本是前端没发对 multipart 结构
二进制流处理的关键不在“怎么读”，而在“从哪读”——选错入口（Body vs FormFile）是 90% 问题的根源。multipart 场景下永远信任 FormFile().Open()，raw body 场景才碰 Request.Body，且必须设限。
