中间件注册顺序严格决定执行顺序：先注册的在请求阶段先执行、响应阶段后执行；必须显式调用ctx.Next()才能进入下一环节，否则链路中断。
中间件注册顺序决定执行顺序
在 Iris 中，中间件不是自动串联的，必须显式调用 Use 或 UseGlobal 注册，且顺序严格决定执行顺序 —— 先注册的先执行（请求阶段），后注册的先执行（响应阶段，即倒序出栈）。这点和 Express 或 Gin 不同，容易误以为“注册即生效”而忽略顺序依赖。
常见错误现象：ctx.Next() 在某个中间件里没被调用，后续中间件完全不执行；或者 UseGlobal 和 Use 混用时，全局中间件意外包裹了本不该介入的路由组。
-
Use只作用于当前路由组及其子路由（包括Get/Post等） -
UseGlobal作用于所有路由（包括未分组的），但会在Use之前执行（即最外层） - 若需跳过某中间件，不能靠 return，必须调用
ctx.Next()显式放行
如何编写符合 Iris 链式语义的中间件函数
Iris 中间件本质是 iris.Handler 类型，签名固定为 func(ctx iris.Context)。它不返回值，也不接收 next 参数 —— 控制流由 ctx.Next() 显式驱动，这是关键差异。
使用场景：日志、鉴权、跨域、请求体解析等。注意不要在中间件里直接调用 ctx.StopExecution() 后还继续写逻辑，Iris 不会自动中断后续代码执行。
示例（带条件跳过的鉴权中间件）：
authMiddleware := func(ctx iris.Context) {
token := ctx.GetHeader("Authorization")
if token == "" {
ctx.StatusCode(401)
ctx.WriteString("missing auth header")
return // 必须 return，否则 ctx.Next() 还会执行
}
// 验证通过，放行
ctx.Next()
}
- 所有中间件必须主动调用
ctx.Next()才能进入下一个中间件或最终 handler - 若中间件内发生 panic，Iris 默认不 recover，需自行用
defer/recover包裹（尤其在解析 JSON、DB 查询等易错环节） - 避免在中间件中多次调用
ctx.ResponseWriter().Write()，可能触发 “http: multiple response.WriteHeader calls” 错误
UseGlobal 和 Use 混用时的执行层级陷阱
当同时使用 UseGlobal 和 Use 时，实际执行顺序是：全局中间件 → 路由组中间件 → handler。但很多人误以为 UseGlobal 是“兜底”，结果发现跨域中间件（UseGlobal）把健康检查接口也包进去了，而该接口本应裸奔。
性能影响：每层中间件都会增加一次函数调用开销，但通常可忽略；真正影响性能的是中间件内部操作（如 DB 查询、远程调用），而非链本身。
-
UseGlobal注册的中间件无法按路径排除，如需条件启用，必须在中间件函数内手动判断ctx.Path()或ctx.Method() - 路由组
app.Party("/api")上调用Use，只影响该组及子组，不影响/health这类根路径路由 - 调试技巧：在每个中间件开头加
fmt.Printf("[MIDDLEWARE] %s %s → %s\n", ctx.Method(), ctx.Path(), "xxx")，观察实际执行流
中间件中读写上下文数据的正确方式
Iris 提供 ctx.Values().Set() 和 ctx.Values().Get() 来跨中间件传递数据，这是唯一推荐方式。不要用闭包变量或全局 map —— 并发不安全，且无法隔离不同请求上下文。
容易踩的坑：用 ctx.Values().GetString() 时没判空，导致 panic；或在中间件 A 中 Set 了 key，在中间件 B 中用 Get 拿到 nil 后直接类型断言，崩溃。
- 设值：
ctx.Values().Set("user_id", 123) - 取值（安全）：
if uid, ok := ctx.Values().Get("user_id").(int); ok { ... } - 生命周期：
ctx.Values()与单次请求绑定，请求结束自动销毁，无需手动清理 - 注意：
ctx.Values()不是 context.Context 的 Value，二者无关，别混用
ctx.Next() 控制流的理解深度 —— 它不像其他框架那样隐式流转，而是要求你每一层都明确“是否继续”。漏掉一次 ctx.Next()，整条链就断在那儿，而且没有任何警告。 
