Iris中间件必须是func(iris.Context),按序执行,校验失败需ctx.StopExecution()阻断,成功则调ctx.Next();路由组用app.Party("/path", m1, m2)添加;读Body后需重置;ctx.User.Set()需确保中间件覆盖且结构体实现iris.User接口。

中间件函数签名和执行时机怎么写才对
Iris 中间件必须是 iris.Handler 类型,也就是 func(iris.Context)。它不是“拦截后转发”,而是“每次请求进来时按顺序执行”。你不能靠 return 退出逻辑,必须显式调用 ctx.StopExecution() 阻断后续 handler;否则即使你写了响应体,ctx.Next() 之后的业务逻辑仍会继续跑,可能造成重复写响应或 panic。
常见错误是把中间件写成:
func badMiddleware(ctx iris.Context) {
if !isValid(ctx) {
ctx.StatusCode(401)
ctx.JSON(map[string]string{"error": "unauthorized"})
return // ❌ 错!没 stop,后续 handler 还会执行
}
ctx.Next()
}
正确写法是:
- 校验失败时:先设状态码、写响应,再立刻
ctx.StopExecution() - 校验通过时:只调
ctx.Next(),不要 return 或额外写响应 - 中间件里不要 defer ctx.Next() —— 它不是钩子,是明确的“继续执行链”的指令
怎么给特定路由组加中间件而不是全局生效
用 app.Party() 创建子路由器,第二个参数传入中间件切片,比如 app.Party("/api", authMiddleware, loggerMiddleware)。这个组下注册的所有路由(包括嵌套 Party)都会自动套上这些中间件。
注意两点:
-
app.Party()返回的是新的Party实例,不是原app,所以后续.Get()等方法要链在它后面,不能还写app.Get() - 中间件顺序很重要:前面的中间件能修改
ctx并影响后面的中间件;比如authMiddleware必须在loggerMiddleware前,否则日志拿不到用户信息
如何在中间件里安全读取和修改请求/响应数据
读请求头、参数、Body 要小心生命周期和并发安全。Iris 的 ctx.Request() 是标准 *http.Request,但 Body 只能读一次 —— 如果你在中间件里调了 ctx.ReadJSON() 或 ctx.PostValue(),业务 handler 再读就会得到空值。
解决方案:
- 只在必要中间件里读 Body,且用完后手动重置:
ctx.Request().Body = ioutil.NopCloser(bytes.NewBuffer(bodyBytes))(需先ioutil.ReadAll) - 优先用
ctx.URLParam()、ctx.Params().Get()读路径参数,它们不消耗 Body - 写响应时别直接操作
ctx.ResponseWriter()的底层http.ResponseWriter,要用ctx.Text()、ctx.JSON()等封装方法,否则可能绕过 Iris 的状态码管理
为什么 ctx.User.Set() 在中间件里不起作用
ctx.User.Set() 不是全局变量赋值,它依赖 ctx.User 内部的存储机制,而该机制只在 ctx 生命周期内有效。如果你在中间件里调了 ctx.User.Set(&u),但后续 handler 拿不到,大概率是因为:
- 中间件没调
ctx.Next(),导致 handler 根本没执行 - handler 所在的路由没被该中间件覆盖(比如用了
app.Get()而不是party.Get()) -
&u对应的结构体没实现iris.User接口(至少要有ID() string方法)
验证方式:在 handler 里打印 ctx.User.Get() 结果,而不是只信中间件里的 log。











