Go语言中使用Gin框架防止大文件上传导致服务器磁盘写满的配置-Golang-PHP中文网

maxmultipartmemory用于限制gin解析multipart表单时的内存缓冲上限，超出后自动转存磁盘；需显式设置，建议远低于服务器可用内存（如32mb）。

go语言中使用gin框架防止大文件上传导致服务器磁盘写满的配置

如何用 `MaxMultipartMemory` 限制单次上传内存占用

Gin 默认允许无限大的 multipart 表单上传，但 MaxMultipartMemory 是唯一能直接控制解析阶段内存（而非磁盘）上限的配置。它不阻止大文件上传，而是限制 Gin 在内存中缓冲的字节数；超出后会自动转存到临时磁盘文件——这正是磁盘写满的起点。

关键点：这个值必须显式设置，且建议远低于服务器可用内存（比如设为 32 即 32MB），否则默认的 32MB 可能仍导致并发多请求时内存暴涨或触发磁盘落盘。

r := gin.Default() 后立即调用 r.MaxMultipartMemory = 32
若使用 gin.New()，需在 r.MaxMultipartMemory = ... 之后再加载中间件（如 r.Use(gin.Recovery())）
该配置只影响 c.FormFile() 和 c.MultipartForm()，对原始 c.Request.Body 无约束

为什么 `SetMaxMultipartMemory` 不是 Gin 的合法方法

常见错误是搜索 “Gin 设置最大上传大小” 后误用不存在的 SetMaxMultipartMemory 方法，结果编译报错 undefined: r.SetMaxMultipartMemory。Gin 没有 setter 方法，MaxMultipartMemory 是一个可导出的 public 字段，直接赋值即可。

混淆来源：某些旧版博客或 Stack Overflow 答案把其他框架（如 Echo）的 API 套用到 Gin 上。正确做法只有字段赋值，没有封装函数。

❌ 错误写法：r.SetMaxMultipartMemory(32
✅ 正确写法：r.MaxMultipartMemory = 32
该字段类型为 int64，单位是字节，不能传字符串或带单位（如 "32MB"）

配合 `http.MaxBytesReader` 防止原始 Body 耗尽磁盘

MaxMultipartMemory 只管 multipart 解析，而攻击者可能绕过表单、直接发超大 raw body（如 curl -X POST --data-binary @huge.bin）。这时需在路由前加一层底层限制。

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

标准做法是在 Gin handler 外层包装 http.MaxBytesReader，它会在读取 c.Request.Body 时实时拦截超额数据，并返回 413 Request Entity Too Large。

在 r.POST("/upload", ...) 前插入中间件：

func limitBodySize(max int64) gin.HandlerFunc {
    return func(c *gin.Context) {
        c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, max)
        c.Next()
    }
}
r.POST("/upload", limitBodySize(10