c.formfile 返回 nil 是因 fiber 默认不自动解析 multipart 表单，须先调用 c.multipartform 或 c.formvalue 等触发解析的方法，否则无法获取文件。
c.FormFile 是 Fiber 处理上传文件的入口，但它本身不解析 multipart 表单——必须先调用 c.MultipartForm 或隐式触发解析（比如调用 c.FormValue 后再调用 c.FormFile），否则会返回 nil 和错误。
很多初学者卡在“取不到文件”上，根本原因就是漏了这一步。
为什么 c.FormFile 返回 nil？
因为 Fiber 默认不会自动解析 multipart 表单体。它只在你显式调用 c.MultipartForm、c.FormValue、c.BodyParser 等会触发解析的方法后，才把 multipart.Form 缓存到上下文里。
所以直接写：
file, err := c.FormFile("uploadfile")
大概率得到 file == nil 和 err != nil（错误信息类似 no multipart form data）。
正确做法是：
- 先调用
c.MultipartForm()，再取c.FormFile - 或改用
c.FormValue("xxx")触发一次解析（哪怕只是读个无关字段） - 或在路由 handler 前加中间件统一解析（适合全站都需要表单处理的场景）
如何安全读取并保存上传的文件
拿到 *multipart.FileHeader 后，不能直接用 file.Open() 读取——它返回的是一个临时文件句柄，底层可能还没写完；更不能用 file.Size 做唯一校验，因为攻击者可伪造 header。
推荐流程：
- 用
file.Header.Get("Content-Type")检查 MIME 类型（如image/jpeg），而非仅依赖后缀 - 用
file.Size+ 配置项做大小限制（例如不超过 10MB），超限立即返回 400 - 用
file.Open()获取io.Reader，再通过io.Copy流式写入目标路径（避免全量加载进内存） - 写入前确保目标目录存在，且权限可控（不要用用户输入拼接路径，防目录穿越）
示例关键片段：
file, err := c.FormFile("uploadfile")
if err != nil {
return c.Status(400).SendString("no file received")
}
if file.Size > 10*1024*1024 {
return c.Status(400).SendString("file too large")
}
src, _ := file.Open()
defer src.Close()
dst, _ := os.Create("./uploads/" + file.Filename)
defer dst.Close()
io.Copy(dst, src)
大文件上传时内存和超时怎么控制
Fiber 底层用的是 fasthttp，它默认把整个请求体读进内存再交给 handler。对大文件上传来说，这是灾难性的——100MB 文件进来，就占掉 100MB 内存，还可能触发 OOM Kill。
必须主动干预：
- 在
fiber.Config中设置BodyLimit: 10 * 1024 * 1024（比如限制请求体最大 10MB），超过直接 413 - 用
c.Context().SetBodyStreamWriter自定义流式响应（但上传仍需先过 body limit） - 真正的大文件（>50MB）应走分片上传：前端切片 + 后端接收单片 + 合并逻辑，此时每个请求体都很小
- 同时调整
ReadTimeout和WriteTimeout，避免上传慢导致连接被关
和 MinIO 集成时要注意什么
如果上传目标是 MinIO（或任何 S3 兼容对象存储），别把文件先落地再传——既浪费磁盘 IO，又多一次内存拷贝。
应该用 file.Open() 得到的 io.Reader 直接传给 MinIO 的 PutObject：
src, _ := file.Open()
defer src.Close()
info, err := minioClient.PutObject(context.Background(), "my-bucket", file.Filename, src, file.Size, minio.PutObjectOptions{
ContentType: file.Header.Get("Content-Type"),
})
注意点：
-
PutObject要求传入准确的size，所以仍需检查file.Size - MinIO 不支持 streaming upload（即 chunked encoding），所以必须知道总长度
- 若要支持断点续传或秒传，得额外实现文件哈希计算和去重逻辑，Fiber 本身不提供
Fiber 的文件上传看似简单，但绕不开 multipart 解析时机、内存控制、路径安全、存储对接这四道坎。最容易被忽略的是第一点：没调用任何触发解析的方法就直接 FormFile，然后花半天查为什么 file 是 nil。
