Iris框架如何配置中间件-Golang-PHP中文网

中间件必须显式注册，全局用app.use、路由级作为处理器参数传入，顺序决定执行顺序；需调用ctx.next()才能继续，否则中断链路；app.done为响应后钩子，不可修改响应。

iris框架如何配置中间件

中间件必须显式注册才能生效，Iris 不会自动加载或按名称匹配；全局中间件用 app.Use，路由级用 app.Get 等方法的参数列表传入，顺序决定执行顺序。

全局中间件在每次请求进入时都会执行，适合日志、鉴权、跨域等通用逻辑。它只对 app.Use 之后注册的路由生效，注册顺序无关紧要，但执行顺序严格按注册先后。

示例：

app.Use(func(ctx iris.Context) {
    fmt.Println("log: start")
    ctx.Next() // 必须有，否则后续全被阻断
})

适用于仅需对特定路径启用的逻辑，比如 /admin 下的权限校验、/api/v1 下的限流。它和全局中间件可共存，执行时先走全局，再走路由级，最后是处理器本身。

Iris框架 12.2.5

Iris框架 12.2.5 版本源码包下载，适合需要 MVC Singleton 控制器、依赖注入字段控制和 debug 错误日志改进的开发者。

下载

写法是把中间件函数放在 app.Get、app.Post 等方法的参数末尾，如 app.Get("/user", authMiddleware, userHandler)
多个中间件按从左到右顺序执行，每个仍需手动调用 ctx.Next()
注意：如果路由级中间件里提前 ctx.StopExecution() 或 ctx.StatusCode(401) 后未调用 ctx.Next()，处理器不会运行
常见误用：把 ctx.Next() 写在 return 之后，导致它永不执行

app.Done 注册的函数会在所有中间件和处理器执行完毕、响应已写出后触发，常用于清理资源或记录耗时，但它无法修改响应内容或状态码。

示例：

app.Done(func(ctx iris.Context) {
    fmt.Printf("done: %s %s in %v\n", ctx.Method(), ctx.Path(), time.Since(ctx.Values().GetDuration("start")))
})

中间件函数签名固定为 func(iris.Context)，所有请求数据都通过 ctx 获取，但不同阶段可用的数据范围不同。

ctx.Params().Get("id") 在路由匹配完成后才有效，因此不能在 app.Use 的早期中间件中直接读取路径参数（除非你确定该路由一定带参数）
ctx.FormValue("key") 和 ctx.ReadJSON() 会消费请求 Body，多次调用会导致后续读取失败；如需复用，应先用 ctx.Request().Body 缓存并重置
ctx.Values().Set("user", u) 可跨中间件传递数据，但要注意 key 名冲突；建议用自定义类型做 key，避免字符串硬编码
不要在中间件里启动 goroutine 并直接操作 ctx——ctx 不是线程安全的，异步场景应提取必要字段后传参