Echo框架怎么限制上传文件的大小-Golang-PHP中文网

必须显式用 http.MaxBytesReader 包装 r.Body，因为 Echo 的 e.MaxRequestBodySize 仅在路由匹配前生效，一旦中间件或 handler 提前读取 r.Body（如 ParseForm、FormFile），原始 body 即被清空导致限流失效。

echo框架怎么限制上传文件的大小

必须显式用 http.MaxBytesReader 包装 r.Body，Echo 自带的 e.MaxRequestBodySize 在多数场景下不生效——尤其当你调用了 c.FormFile()、c.MultipartForm() 或任何提前读取 r.Body 的操作之后。

为什么 `e.MaxRequestBodySize` 经常失效

Echo 的 e.MaxRequestBodySize 底层确实调用了 http.MaxBytesReader，但它只在请求进入路由匹配前生效。一旦中间件或 handler 提前消费了 r.Body（比如解析 multipart、调用 ParseForm()、甚至 io.ReadAll(r.Body)），原始 body 就已为空，后续包装形同虚设。

自定义 JWT 中间件里执行了 r.ParseForm() → r.Body 被清空，限流失效
handler 中绕过 c.ShouldBind()，直接用 json.NewDecoder(c.Request.Body).Decode() → 没手动套 http.MaxBytesReader，等于裸奔
用了 c.FormFile("file") → 它内部会调用 r.ParseMultipartForm()，提前读取并丢弃 body 流

正确做法：在 handler 开头手动限流

对每个需要上传的 endpoint，在 handler 最开头就包装 r.Body，且必须在任何解析逻辑之前执行：

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

func uploadHandler(c echo.Context) error {
    // ✅ 必须放在最前面！
    c.Request().Body = http.MaxBytesReader(c.Response(), c.Request().Body, 10*1024*1024) // 10MB
<pre class="brush:php;toolbar:false;">// ❌ 不能再调 c.FormFile() 或 c.MultipartForm()
file, err := c.FormFile("video")
if err != nil {
    return c.String(http.StatusBadRequest, "no file received")
}

src, err := file.Open()
// ...

}

限流值单位是字节，10*1024*1024 表示 10MB；不要写成 10MB 字面量（Go 不支持）
若需支持大文件分片上传，必须设 c.Request().ParseMultipartForm(0) 禁用自动解析，否则 c.FormFile() 会吞掉原始 body
若同时处理 multipart 表单字段 + 文件，得用 http.MaxBytesReader 限制总大小，再用 r.ParseMultipartForm(8 * 1024 * 1024) 控制内存缓存上限（如 8MB），超出部分自动落盘