Iris中ctx.ReadJSON只能调用一次，重复调用会panic；必须在中间件首次解析后存入ctx.Values()供handler复用，不可手动重放Body。
并发请求下ctx.ReadJSON可能 panic
Iris 默认不为 ctx.ReadJSON 加并发保护，多个 goroutine 同时调用它读取同一个 ctx.Request().Body 会触发 http: read on closed response body 或直接 panic。这不是你代码逻辑错，而是 Go 标准库底层限制：Request.Body 是单次读取流。
常见错误场景：在中间件里提前调用 ctx.ReadJSON(&v) 做日志或鉴权，再在 handler 里又调一次——第二次必然失败。
- 必须确保整个请求生命周期中，
ctx.ReadJSON最多被调用一次 - 若需多次使用解析结果，应在第一次成功后缓存到
ctx.Values().Set("json-payload", v) - 不要依赖
ctx.Request().Body手动重放，Iris 不提供类似ctx.ResetBody()的 API - 对 JSON 请求，推荐统一在入口中间件解析并存入 context，后续 handler 直接取
ctx.Values().Get("json-payload")
路由注册顺序影响并发安全的中间件执行
Iris 中间件是链式执行的，但它的注册时机和顺序决定了并发请求是否能按预期进入完整流程。比如你在 v1 := app.Party("/v1") 后调用 v1.Use(authMiddleware)，而 authMiddleware 里用了全局 map 存 token 缓存却没加锁——高并发下会直接 panic。
典型坑点：
-
app.UseGlobal()注册的中间件对所有路由生效，包括健康检查、静态资源等非业务路径，别在里面写强依赖 DB 或 Redis 的逻辑 - 中间件内操作共享状态（如计数器、缓存）必须显式加锁，
sync.RWMutex比sync.Mutex更合适 - 不要在中间件里调用阻塞型 I/O（如未设 timeout 的 HTTP client 调用），否则整个 goroutine 被卡住，连接池迅速耗尽
- 用
ctx.Next()控制流程继续，漏掉它会导致后续 handler 完全不执行，看起来像“请求消失”
嵌套路由组 + 并发中间件容易忽略的前缀隔离失效
当你用 api := app.Party("/api/v1") 创建分组，再用 users := api.Party("/users") 嵌套，看似隔离了路径，但中间件注册不匹配前缀会导致并发请求行为不一致。
例如：
- 在
users分组注册了限流中间件：users.Use(rateLimitMiddleware) - 但误把另一个中间件注册到了
app.Use()，它会对/health、/metrics等路径也生效 - 高并发时，/health 接口被限流拖慢，监控系统误报服务不可用
- 更隐蔽的是：如果
app.Party("/admin")和api.Party("/api/v1")共享了某个中间件，而该中间件内部用了ctx.Path()做路由判断，没考虑前缀差异，就可能把/admin/login错当成/api/v1/login处理
并发压测时 app.GetRoutes() 输出不可靠
app.GetRoutes() 返回的是启动时注册的路由快照，它本身不是线程安全的。在热更新路由（比如动态加载插件）、或并发调用 app.Handle() 的场景下，调用它可能 panic 或返回不完整列表。
真正需要排查并发问题时，别依赖这个函数实时诊断：
- 启动阶段用
app.GetRoutes()做一次性校验即可，比如 CI 中断言关键路由存在 - 运行时想看当前活跃路由，应配合
iris.Logger().SetLevel(iris.LogDebug)，从启动日志里确认路由树结构 - 若需动态调试，建议封装一个带 mutex 的路由注册器，在每次
app.Get/app.Post后同步更新本地 map，再提供线程安全的查询接口 - 注意：
app.GetRoutes()不包含app.Any()注册的通配路由，它们在内部用不同结构存储，容易漏检
