iris v12+ 默认日志为 zerolog.logger，iris.logger() 返回未初始化的零值，无法获取 zap 实例；必须手动注入 zap.logger 到控制器构造函数，并通过 c.values() 传递请求上下文字段。
直接用 iris.Logger() 无法和 Zap 集成，Iris v12+ 默认日志是 *zerolog.Logger，不是 Zap；必须手动注入已配置的 *zap.Logger 实例，否则日志会丢失、字段不统一、上下文断裂。
为什么不能直接调用 iris.Logger() 获取 Zap 实例
Iris 的 iris.Logger() 是一个未初始化的全局单例函数，v12+ 返回的是 *zerolog.Logger 类型，和 Zap 完全无关。它不参与应用启动时的日志配置流程，也不会读取你初始化好的 *zap.Logger。如果你在控制器里写 iris.Logger().Info(...)，要么 panic（nil pointer），要么打到空 handler，日志根本不会落盘。
- 真正可用的日志对象必须来自
app.Logger()—— 但这个方法返回的仍是 zerolog 实例，不是 Zap - 想用 Zap，就得绕过 Iris 的日志抽象层，自己管理
*zap.Logger生命周期 - 常见错误：在中间件里调用
c.Set("logger", zapLogger.With(...))，然后控制器里c.Get("logger")断言为*zap.Logger—— 这样做字段能传，但With()创建的子 logger 没有绑定 caller、encoder 等上下文，Sync()也容易漏掉
如何把 *zap.Logger 安全注入到 Iris MVC 控制器
推荐方式是构造函数传参，避免每次请求都获取或转换实例，也规避 context.WithValue 的分配开销和类型断言风险。
- 控制器定义中显式声明字段：
logger *zap.Logger - 工厂函数（如
NewUserController(app iris.Application)）里传入已初始化的全局*zap.Logger实例 - 不要依赖
BeginRequest或BeforeActivation注入 —— Iris 的 Controller 接口不强制实现这些，且生命周期不可控 - 如果要用请求级字段（如
trace_id,path），在中间件里生成后存入c.Values().Set("trace_id", tid)，控制器内用logger.With(zap.String("trace_id", tid))构建子 logger，而不是反复调用With()
zap.Logger 初始化时哪些选项不能漏
Zap 的性能优势极度依赖初始化配置，漏掉任意一项都可能让吞吐跌回标准库水平，尤其在 Iris 这种高并发 HTTP 框架中。
- 必须用
zapcore.Lock(zapcore.AddSync(fileWriter))包裹文件 writer —— Iris 多 goroutine 并发处理请求，裸写*os.File会 panic - 编码器必须用
zapcore.NewJSONEncoder，禁用自定义时间格式：EncodeTime: zapcore.ISO8601TimeEncoder；用time.Now().Format(...)会触发每次日志分配字符串 - 务必加
zap.AddCaller()—— 它走编译期内联，比runtime.Caller快 3–5 倍，且字段名是caller，Iris 中能准确定位到 controller 方法 - 避免用
zap.NewProduction()直接返回值 —— 它内部用的是os.Stderr和固定 encoder，无法接入 lumberjack 轮转逻辑
怎么让每条日志自动带上 HTTP 请求上下文
Iris 不自动注入 path、method、status 等字段，全靠手动拼接；但别在每个 handler 里重复写 logger.With(...).Info(...)，容易漏、难维护、性能差。
- 在全局中间件中统一提取并写入
c.Values()：c.Values().Set("method", c.Method())、c.Values().Set("path", c.Path())、c.Values().Set("status_code", 0)（状态码需在 response 写完后回调设置） - 封装一个
ctxLogger(c iris.Context) *zap.Logger工具函数，内部读取c.Values()并调用logger.With()一次生成带上下文的子 logger - 注意：子 logger 的
Sync()不会自动刷父 logger 缓冲区，必须确保主 logger 的defer logger.Sync()覆盖整个程序生命周期，尤其是app.Run()之后 - 错误日志别只用
zap.Error(err)—— 如果 err 不带堆栈（比如标准os.ErrNotExist），就看不到调用链；建议统一用zap.NamedError("err", err)或手动加zap.String("stack", debug.Stack())（仅 error 级别）
最易被忽略的是 logger.Sync() 的作用域 —— 它只刷当前 logger 及其所有子 logger 的缓冲区，但子 logger 本身不持有 writer，所以只要主 logger 的 Sync() 被调用，所有 With 出来的实例都会生效；别在每个 handler 末尾都调一遍 Sync()，那是浪费 CPU。
