必须在路由注册前用 middleware.BodyLimit("50MB") 全局设限,否则大请求会耗尽内存或被 Nginx 截断;还需配合 Content-Length 头校验、e.MaxMultipartMemory 设置及 e.MaxMultipartMemoryBodyLimit 防绕过。

必须在路由注册前用 middleware.BodyLimit() 全局设限
Echo 默认完全不限制请求体大小,不加这层限制,一个 2GB 的 POST 请求会直接耗尽内存或被 Nginx 静默截断,前端看到的是 ERR_CONNECTION_ABORTED 或空响应,而不是 413 错误。你不能依赖后续 handler 里的校验——等走到那里,文件可能已写满磁盘。
正确做法是:在 e := echo.New() 之后、任何 e.GET() 或 e.POST() 之前,调用 e.Use(middleware.BodyLimit("50MB")):
- 单位必须是字符串,如
"10MB"、"2G",不能写10 * 1024 * 1024这类数字 - 该限制作用于整个请求体(含 multipart boundary、所有表单字段和所有文件),不是单个文件大小
- 它底层调用
http.MaxBytesReader,但只在r.Body未被提前读取时生效;若中间件里调了r.ParseForm()或io.ReadAll(r.Body),这个限流就彻底失效
Content-Length 头检查要放在中间件里做快速拦截
仅靠 BodyLimit 不够安全,因为攻击者可伪造 Content-Length,但内网或反向代理后它是可靠的第一道过滤器。你应在路由 handler 前加自定义中间件,读取并比对该头:
- 用
c.Request().Header.Get("Content-Length")获取值,strconv.ParseInt()转成int64 - 若超过阈值(如
10 * 1024 * 1024),立即返回echo.NewHTTPError(http.StatusRequestEntityTooLarge, "file too large") - 注意:分块传输(
Transfer-Encoding: chunked)时该头不存在,此时需回退到BodyLimit或MaxBytesReader控制
上传接口必须额外配 e.MaxMultipartMemory
BodyLimit("50MB") 管总大小,但 multipart 场景下攻击者可发一个 1KB 文本字段 + 49.99MB 文件,绕过逻辑校验。真正起作用的是 ParseMultipartForm 的内存阈值控制——它决定多少字节留在内存、超出后落盘。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
你需要显式设置:e.MaxMultipartMemory = 8 (即 8MB):
- 这个值必须小于你期望拦截的单文件上限;比如要拦 10MB 文件,就得设成 ≤9MB,否则超限部分照常落盘且不报错
- 它不影响总请求体大小,只影响解析时内存缓冲策略;配合
BodyLimit才构成完整防线 - 设得太小(如 1MB)会导致小文件也频繁落盘,增加 I/O;设太大(如 50MB)等于没设
细粒度控制得用 http.MaxBytesReader 手动包装 r.Body
当 /login 和 /upload 需要不同上限(比如前者限 2MB、后者限 100MB),BodyLimit 就不够用了。必须在具体 handler 开头手动重置 r.Body:
- 在 handler 函数第一行写:
c.Request().Body = http.MaxBytesReader(c.Response(), c.Request().Body, 100 - 必须在任何读取
r.Body的操作之前执行,包括c.FormFile()、c.ShouldBindJSON()、r.ParseMultipartForm() - 如果用了 JWT 中间件且它调了
r.ParseForm(),那这行代码就晚了——得把MaxBytesReader提到那个中间件里,或者改用MaxBytesHandler全局包裹
关键点在于:BodyLimit 是便捷入口,但它的生效极度依赖执行顺序;真正防住恶意上传的,是 Content-Length 检查 + BodyLimit + MaxMultipartMemory 三层叠加,缺一不可。任何一层被绕过,攻击者就能把临时目录塞爆。


















