Echo框架默认不限制请求体大小，因其实例创建后允许任意大小请求体，必须显式使用echo.BodyLimit中间件或http.MaxBytesReader手动包装r.Body，否则恶意大请求易致OOM或连接池耗尽。
为什么默认的 echo.MiddlewareFunc 不会自动限制请求体大小
Echo 框架本身不内置全局请求体大小校验，echo.New() 创建的实例默认允许任意大小的请求体（受限于 Go HTTP server 底层，但通常远超业务需要）。如果不显式配置，攻击者可能通过超大 POST/PUT 请求耗尽内存或触发 OOM。
常见错误现象：http: request body too large 错误由 Go 标准库在解析时抛出，但此时请求已进入 Echo 生命周期，中间件无法拦截；或者更糟——服务直接 panic 或响应延迟飙升。
- Go HTTP server 默认限制是
10MB（通过http.MaxBytesReader隐式控制），但这个值不可配且不与 Echo 中间件体系联动 - 使用
c.Request().Body手动读取前不做检查，会导致整个 body 被加载进内存，失去流式处理能力 -
echo.HTTPError无法在标准中间件中提前返回 413，因为底层 reader 尚未被包装
用 echo.BodyLimit 中间件最简实现 413 响应
echo.BodyLimit 是 Echo 官方提供的轻量中间件，它在请求进入路由前包装 http.Request.Body，对读取字节数做硬限制，并在超限时直接返回 413 Payload Too Large。
示例：限制所有请求体不超过 2MB
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
import "github.com/labstack/echo/v4"
e := echo.New()
e.Use(echo.BodyLimit("2M"))
- 单位支持
B、K、M、G（大小写不敏感），如"512K"、"1G" - 该中间件只作用于
Content-Length已知的请求；对分块传输编码（chunked）请求，限制在首次读取时生效 - 若需自定义错误响应（比如 JSON 格式），需配合
e.HTTPErrorHandler全局设置，而非修改中间件本身
需要细粒度控制？手动包装 http.MaxBytesReader
当你要按路径、方法或 Content-Type 区分限制（例如 API 接口限 1MB，文件上传接口限 50MB），就不能只靠全局 BodyLimit。必须在具体 handler 内部或自定义中间件中调用 http.MaxBytesReader。
关键点：必须在调用 c.Request().Body 之前完成包装，否则原始 body 已被读取或关闭
func uploadHandler(c echo.Context) error {
// 仅对 /upload 路径启用 50MB 限制
limitedBody := http.MaxBytesReader(c.Response(), c.Request().Body, 50*1024*1024)
c.SetRequest(c.Request().WithContext(
context.WithValue(c.Request().Context(), echo.ContextKey, c),
).WithContext(
context.WithValue(c.Request().Context(), "limited-body", limitedBody),
))
// 后续用 limitedBody 替代 c.Request().Body
return nil
}
- 注意：不能直接赋值
c.Request().Body = ...，因为*http.Request是不可变结构体字段 - 推荐做法是把包装后的 reader 存入
c.Set()，并在后续逻辑中显式取出使用 - 如果用了
c.Bind()（如绑定 JSON），它内部会直接读c.Request().Body，此时必须提前替换整个Request对象（用c.SetRequest()）
和 echo.MultipartForm 配合时的坑
当请求含 multipart/form-data，echo.BodyLimit 仍有效，但它只限制原始字节流总长，不区分文件字段和其他字段。而 c.MultipartForm() 的行为受 Go 标准库 ParseMultipartForm 影响，默认内存阈值是 32MB，超出后临时文件写磁盘——这可能导致磁盘爆满或 I/O 阻塞。
- 务必同步设置
c.Request().MultipartReader()前的 body 限制，否则ParseMultipartForm可能读到非法大体积数据 - 若要限制单个文件大小，不能只靠 body 总限，得在解析后检查
form.File["file"][0].Size - 避免同时用
BodyLimit("10M")和ParseMultipartForm(100 ，后者会覆盖前者效果——优先以 <code>BodyLimit为准，再在业务逻辑里校验单文件
真正难处理的是流式上传场景：既要限制总量，又要支持分片、断点续传、进度回调——这时候得绕过 BodyLimit，改用自定义 reader + 实时计数器，且必须小心处理连接中断和重复读取。
