必须在 handler 第一行用 http.MaxBytesReader 包装 r.Body,否则限制失效;因其仅在首次 r.Body.Read() 时生效,若 ParseForm 等操作前置,Body 已被读取,后续包装无效。

必须在任何读取操作前用 http.MaxBytesReader 包装 r.Body,否则限制完全无效——这不是可选项,是 Go HTTP 处理模型决定的硬性顺序。
为什么 http.MaxBytesReader 必须放在 handler 第一行?
http.MaxBytesReader 不是中间件或拦截器,它只在第一次调用 r.Body.Read()(包括 r.ParseForm()、json.NewDecoder(r.Body).Decode()、io.ReadAll(r.Body))时才开始计数。一旦这些操作先发生,Body 可能已被部分或全部读入内存,后续再包装就等于没设。
- 常见错误现象:
panic: runtime: out of memory、服务变慢但日志无报错、http: TLS handshake error伴随连接堆积 - 框架如 Gin 的
c.ShouldBindJSON()默认不自动启用限流;绕过它直接读c.Request.Body,也必须手动套http.MaxBytesReader - 中间件(如 JWT 验证)若提前调用了
r.ParseForm()或io.ReadAll(r.Body),业务 handler 就永远收不到原始未读 Body,限制必然失效
如何正确配置 multipart 文件上传的大小防护?
仅靠 r.ParseMultipartForm(maxMemory) 不能限制总上传体积——它的 maxMemory 参数只控制“多少字节放内存”,超出部分会写临时文件,但攻击者仍可发一个 100MB 文件 + 1KB 字段,轻松绕过。
- 真正有效的组合是:先用
r.Body = http.MaxBytesReader(w, r.Body, 50 * 1024 * 1024)限制总请求体(含所有字段 + 所有文件) - 再调用
r.ParseMultipartForm(32 设置内存阈值,避免小文件全进内存挤占资源 -
FileHeader.Size可被客户端任意伪造,绝不能替代http.MaxBytesReader的实时字节流截断 - 不显式调用
ParseMultipartForm,Go 也会在首次访问表单数据时自动触发默认解析(32 ),所以“不调用”不等于“没解析”
全局 vs 单路由限流:选 http.MaxBytesHandler 还是 http.MaxBytesReader?
http.MaxBytesHandler 是全局 wrapper,在请求进入任何路由前就完成限制,更安全、不易遗漏;http.MaxBytesReader 是 per-handler 控制,需每个 handler 显式包装,但支持按路由差异化设置(比如登录接口限 2MB,上传接口限 50MB)。
立即学习“go语言免费学习笔记(深入)”;
- 用
http.ServeMux或自定义http.Handler时,推荐直接包一层:http.MaxBytesHandler(mux, 10 - Gin/Echo 等框架的配置项(如
e.MaxRequestBodySize)本质仍是调用http.MaxBytesReader,但生效前提是:它必须在任何读取r.Body的操作之前完成包装 - Go 1.19+ 支持
http.Server.MaxRequestBodySize全局配置,这是最前置的防线,但旧版本仍需中间件或 handler 内显式处理
最容易被忽略的一点:http.MaxBytesReader 的第二个参数必须传 w(http.ResponseWriter),不是 r;传错会导致 panic。它和 http.MaxHeaderBytes 完全无关,后者需在 http.Server 初始化时配置,控制的是 header 大小而非 body。


















