Fiber v3通过App.Config().BodyLimit在HTTP解析层拦截超限请求,避免OOM;v2无原生支持,仅能中间件补救。需同步配置Nginx client_max_body_size,且业务层仍须校验单文件大小与数量。

fiber v2 和 v3 的文件大小限制机制完全不同
别直接套用旧文档里的 c.FormFile + 手动判断 file.Size,那只是「上传后检查」,不能阻止大文件进内存或耗尽连接。Fiber 的限制必须靠底层 HTTP 解析层拦截,否则攻击者传个 5GB 文件,你的服务在解析 multipart 时就 OOM 了。
v2 使用 fasthttp,但没暴露原生的 body size 钩子;v3 则明确支持 App.Config().BodyLimit,这是真正生效的第一道闸门。
- v2:只能靠中间件包装
c.Context().Request.Body(),再用io.LimitReader包一层,但有 race 条件,且无法阻止 multipart 表单头解析失败 - v3(推荐):直接设
BodyLimit,单位字节,超限请求在路由匹配前就被 fasthttp 拒绝,返回413 Payload Too Large - 注意:v3 要求 Go ≥ 1.25,低于这个版本强行用会 panic
fiber v3 正确设置 BodyLimit 的写法
不是往路由里加逻辑,而是初始化 App 时就定死上限。这个值必须 ≤ 你前置网关(如 Nginx)的 client_max_body_size,否则网关先拦掉,Fiber 根本收不到请求。
app := fiber.New(fiber.Config{
BodyLimit: 20 * 1024 * 1024, // 20MB,必须是 int 类型
})
- 这个限制作用于整个 HTTP 请求体,包括所有文件 + 表单字段 + headers 总和
- 如果业务要支持单个 50MB 文件,就得设至少
50 * 1024 * 1024,但你要同步调高 Nginx 的client_max_body_size - 别设成
0或负数,v3 会退化为无限制,等同于裸奔
单文件大小和数量仍需业务层校验
BodyLimit 管总大小,但防不了“100 个 19MB 的 zip”这种攻击。Fiber 不提供类似 Spring Boot 的 max-file-size 参数,得自己扫 c.MultipartForm。
app.Post("/upload", func(c *fiber.Ctx) error {
err := c.ParseMultipartForm(32 files := c.MultipartForm().File["files"] // 假设 input name 是 files
if len(files) > 5 {
return c.Status(fiber.StatusBadRequest).SendString("too many files")
}
for _, file := range files {
if file.Size > 10*1024*1024 { // 单文件超 10MB
return c.Status(fiber.StatusBadRequest).SendString("file too large")
}
}
// …后续保存逻辑
})
c.ParseMultipartForm(32 的参数是内存缓冲上限,不是文件大小限制;它决定 multipart 头部和小文件是否进内存,大文件仍走临时磁盘- 务必检查
c.MultipartForm().File是否为 nil,未调用ParseMultipartForm就直接取会 panic - 前端也应加
(虽可绕过,但能挡掉大部分误操作)
容易被忽略的边界:分片上传和临时文件清理
如果你用的是分片上传(比如 WebUploader、TUS),BodyLimit 只拦单个分片,不拦整个文件。这时必须靠 upload_id + Redis 记录状态,并配定时任务清理超时分片。
- 每个分片请求仍受
BodyLimit限制,但攻击者可发 1000 个 1MB 分片 → 总量 1GB,而你的磁盘可能只剩 500MB - Fiber 不自动清理
multipart生成的临时文件(路径由系统os.TempDir()决定),上传失败后这些文件常驻磁盘 - 生产环境必须加 cron 或 goroutine 定期执行:
os.RemoveAll(filepath.Join(os.TempDir(), "multipart-*"))











