中间件不生效主因是注册顺序错误：必须在路由前调用app.Use()；漏调ctx.Next()或未用ctx.StopExecution()会导致流程中断；ctx.Values()传值失效多因key类型不一致或拼写错误。
中间件不执行？先确认注册位置和顺序
自定义中间件没生效，最常见原因是注册时机不对。Iris 的中间件必须在路由注册 之前 调用 app.Use() 或 group.Use()，否则对已注册的路由无效。
比如你写了：
app.Get("/api/user", handler)
app.Use(myMiddleware) // ❌ 晚了，/api/user 不会经过它
正确写法是：
app.Use(myMiddleware) // ✅ 全局生效
app.Get("/api/user", handler)
- 若只作用于某组路由，必须用
Party()分组后，在分组对象上调用Use()，不能直接对app调用再期望它只影响子路径 -
app.UseGlobal()仅影响未被分组的根级路由，不会穿透到Party()内部——这点和直觉相反，容易踩坑 - 多个中间件按注册顺序执行，
app.Use(a, b, c)表示 a → b → c；但若混用Use()和UseGlobal()，全局中间件总在分组中间件之前执行
ctx.Next() 被漏掉或放错位置导致流程中断
中间件里忘记调用 ctx.Next()，或者把它放在 return 后、panic 后、条件分支外，都会导致后续中间件和 handler 完全不执行，且无报错——请求就“静默卡住”了。
典型错误写法：
func myMiddleware(ctx iris.Context) {
if ctx.GetHeader("X-Debug") == "" {
ctx.StatusCode(400)
return // ❌ 忘了 ctx.Next()，也没写 ctx.StopExecution()
}
ctx.Next() // ✅ 这行实际永远不会执行
}
正确写法应明确控制流：
func myMiddleware(ctx iris.Context) {
if ctx.GetHeader("X-Debug") == "" {
ctx.StatusCode(400)
ctx.WriteString("missing X-Debug")
ctx.StopExecution() // ✅ 阻断后续，且显式结束
return
}
ctx.Next() // ✅ 放在所有提前返回逻辑之后
}
-
ctx.StopExecution()是必须的，否则 Iris 仍会继续执行后续 handler（哪怕你已写响应） - 不要在 defer 中调用
ctx.Next()，它不会按预期触发 - 如果中间件里有异步操作（如 goroutine），
ctx.Next()不能放在 goroutine 里——上下文可能已被释放
调试时如何快速定位中间件是否运行
最直接的办法是在中间件开头加一行日志并强制刷出，避免缓冲干扰：
func debugMiddleware(ctx iris.Context) {
fmt.Printf("[MIDDLEWARE] %s %s → %s\n",
ctx.Method(), ctx.Path(), time.Now().Format("15:04:05"))
os.Stdout.Sync() // 强制刷新 stdout，防止日志延迟或丢失
ctx.Next()
}
- 别依赖
iris.Logger()打印中间件日志：默认日志中间件本身也是中间件，且可能被你禁用或配置为异步，看不到实时输出 - 用
fmt.Printf+os.Stdout.Sync()最可靠，尤其在开发机上 - 如果用了
app.Use(recover.New())，确保它在你的调试中间件 之后 注册，否则 panic 可能被 recover 捕获，你根本看不到原始 panic 位置
ctx.Values() 传值失效？检查生命周期和 key 类型
中间件通过 ctx.Values().Set("key", value) 传值给后续 handler，但常出现取不到的情况。根本原因有两个：
- key 用了字符串字面量，但在 handler 里用了不同拼写（大小写、空格、下划线），例如中间件设
"user_id"，handler 却读"userId" - 更隐蔽的是：key 类型不是
string，而是自定义类型（如type UserIDKey string），这时Values().Get()会返回 nil —— Iris 的Values是 map[interface{}]interface{}，但 key 比较用的是==，不同类型即使值相同也不等 - 不要在中间件里修改
ctx.Request().URL或ctx.Request().Header后还期望ctx.Params()自动更新——它们只在路由匹配时解析一次，后续修改无效
建议统一用导出常量作 key：
const UserKey = "user" // 中间件 ctx.Values().Set(UserKey, userObj) // handler u := ctx.Values().Get(UserKey)
复杂点在于：中间件嵌套层级深时，ctx.Values() 是共享的，但 ctx.Request().Context() 不是——如果你在中间件里用 context.WithValue() 塞数据，handler 里得从 ctx.Request().Context() 取，而不是 ctx.Values()。两者混用容易丢数据。
