Iris 的 MaxRequestBodySize 仅限制 multipart/form-data 解析,不拦截非表单请求体;防御滞后,恶意大 payload 已入内存,故需用 app.UseGlobal + ContentLength 手动校验。

直接限制请求体大小必须用 app.UseGlobal + ctx.Request().ContentLength 检查,Iris 没有内置的全局 body size 配置项。
为什么不能靠 iris.Configuration{MaxRequestBodySize: xxx}
Iris 的 MaxRequestBodySize 配置只影响 multipart/form-data 解析阶段(即文件上传),对 JSON、纯文本、XML 等非表单类型完全不生效。它不会在读取请求体前拦截,而是在解析时才触发限制——此时恶意大 payload 已经进内存,防御滞后。
- 设
MaxRequestBodySize: 5 (5MB)后,一个 100MB 的 JSON POST 仍会成功进入 handler,只是后续 <code>ctx.ReadJSON()报错 - 该配置对
curl -H "Content-Type: application/json" -d @huge.json类请求无效 - 真正起作用的场景仅限
multipart/form-data中的file字段
手动拦截:在中间件里检查 Content-Length 头
这是最轻量、最前置的防御方式。注意:Content-Length 可被客户端伪造,但配合后续校验足够应对大多数扫描器和脚本小子。
- 用
app.UseGlobal注册全局中间件,避免每个路由重复写 - 先调
ctx.Request().Header.Get("Content-Length"),转成 int64 - 若大于阈值(如 8MB),直接
ctx.StatusCode(413)+ctx.StopExecution(),不往下走 - 若 header 不存在(如 chunked transfer),需额外读取部分 body 判断,但多数 API 场景可忽略此分支
app.UseGlobal(func(ctx iris.Context) {
if cl := ctx.Request().Header.Get("Content-Length"); cl != "" {
if size, err := strconv.ParseInt(cl, 10, 64); err == nil && size > 8<<20 {
ctx.StatusCode(413)
ctx.WriteString("request body too large")
ctx.StopExecution()
return
}
}
ctx.Next()
})
更严格的方案:用 ctx.Request().Body 流式读取校验
当必须防伪造 Content-Length 时,需在中间件中实际读取并计数。但要注意:读过一次后 body 流就不可重用,必须用 ctx.Request().Body = ioutil.NopCloser(...) 回填。
- 用
io.LimitReader(ctx.Request().Body, max)包装原始 body - 读满限制后,用
bytes.NewReader(buf)或strings.NewReader(string(buf))构造新 body - 调
ctx.Request().Body = ioutil.NopCloser(newReader),否则后续ctx.ReadJSON()会报http: read on closed response body - 这个操作有内存拷贝开销,建议只在高风险端点(如文件上传接口)启用
别踩的坑:不要依赖 ctx.ReadJSON 的 panic 或 error 做防御
有人把大 JSON 请求丢给 ctx.ReadJSON(&v),指望它 OOM 崩溃或超时来阻断——这非常危险:
- Go 默认 HTTP server 对大 body 不设 timeout,可能卡住 goroutine 数分钟
- ReadJSON 内部用
json.NewDecoder,它会边读边解析,但大 payload 仍会吃光内存 - panic 无法被 Iris 中间件统一 recover,容易导致进程级崩溃
- 错误信息(如
json: cannot unmarshal ...)暴露服务细节,违反安全最小披露原则
真正的防护点永远在请求入口,而不是等解析层出事。Iris 的设计哲学是“显式优于隐式”,body size 限制也一样——你得亲手写那几行检查逻辑,而不是指望框架替你兜底。


















