iris统一响应必须在中间件末尾调用ctx.next()后检查ctx.values()获取handler写入的结构体，再统一设置状态码和json输出；禁止开头调用ctx.json()，需避免闭包、全局变量及响应体劫持。
中间件里不能直接调用 ctx.JSON() 就完事
很多新手一上来就在中间件里写 ctx.JSON(iris.StatusOK, iris.Map{"code": 0, "data": nil})，结果发现 handler 还是照常执行、响应被覆盖两次，或者根本没生效。原因很简单：Iris 中间件不是“拦截后改写响应”，而是“请求链路上的钩子”，ctx.JSON() 是写响应体的操作，必须在 handler 执行完、且你确定要终止流程时才该调用。
真正能统一响应格式的时机，是在 handler 返回之后、但响应还没写出之前——也就是靠 c.Next() 控制执行顺序，然后在中间件末尾检查上下文状态，再决定是否重写响应。
- 必须在中间件末尾调用
c.Next()，否则 handler 根本不执行 - handler 执行完后，你可以通过
c.Values().Get("response")或自定义 key 拿到业务返回的数据结构 - 不要在中间件开头就
ctx.JSON()，那会跳过 handler，变成纯前置过滤器（比如鉴权），不是统一响应
用 ctx.Values() 传数据，而不是靠全局变量或闭包
想让 handler 把结果塞给中间件，最稳妥的方式是约定一个 key，比如 "json_result"，由 handler 主动存，中间件被动取。这样既解耦，又支持并发安全。
示例 handler 写法：
func(ctx iris.Context) {
data := map[string]interface{}{"user_id": 123, "name": "alice"}
ctx.Values().Set("json_result", iris.Map{
"code": 0,
"msg": "success",
"data": data,
})
}
中间件里读取并输出：
func(ctx iris.Context) {
ctx.Next() // 先让 handler 执行
if v := ctx.Values().Get("json_result"); v != nil {
ctx.JSON(iris.StatusOK, v)
return
}
// 没设置 result，走默认逻辑（比如 404 或透传）
}
- 避免用闭包捕获变量，多个请求会互相污染
- 不要用
ctx.Record() / ctx.Recorder().Body()去劫持响应体——那是为测试设计的，生产环境不稳定 - 如果 handler 出错（如 panic 或校验失败），需提前在 recover 中间件里设好 error 结构，统一兜底
状态码和 JSON 必须一起控制，别拆成两步
常见错误是 handler 里只存数据，中间件里只调 ctx.JSON()，却忘了状态码还是 handler 之前默认的 200。更糟的是有人先 ctx.StatusCode(iris.StatusCreated)，再 ctx.JSON(iris.StatusOK, ...)，结果状态码又被覆盖回 200。
正确做法：把状态码也作为结构体字段存进 ctx.Values()，或者封装一个 WriteJSONResp(ctx, code, data) 工具函数，在 handler 里统一调用。
- 推荐结构：
ctx.Values().Set("json_payload", struct{ Code int; Msg string; Data interface{}; Status int }{...}) - 中间件中取出后：先
ctx.StatusCode(payload.Status)，再ctx.JSON(payload.Status, payload) - 对错误场景（如
ctx.ReadJSON失败），应在校验中间件里直接ctx.StatusCode(iris.StatusBadRequest)+ctx.JSON()并return，不往下走
别忽略 Gzip 和 Content-Type 的隐性影响
即使你封装了统一响应，ctx.JSON() 默认不启用压缩，也不带 charset。前端若解析失败，有时不是 JSON 格式问题，而是响应头缺失或编码不一致。
两个关键点：
- 确保中间件在
iris.Compression之后注册，否则压缩不生效（app.Use(iris.Compression)要放在所有自定义中间件之前） -
ctx.JSON()自动设Content-Type: application/json，但如果你手动用了ctx.Write()或ctx.ResponseWriter().Write()，就得自己补：ctx.ContentType("application/json; charset=utf-8") - 时间字段仍按 RFC3339 输出（如
"2026-10-10T09:14:00+08:00"），前端若依赖 Unix 时间戳，得在结构体里加自定义MarshalJSON方法，不能靠中间件后期替换字符串
ctx.Redirect() 或 ctx.ServeFile()，中间件里的 ctx.JSON() 就完全失效——得靠 handler 自己判断类型，或用更细粒度的路由分组隔离。
