Iris 不内置日志脱敏因其专注 HTTP 层，脱敏需由底层日志库（如 zerolog）通过 Hook 实现字段递归检查与替换，避免字符串拼接、确保全局注册并覆盖多源日志。
Logback 和 Log4j2 是 Java 生态主流日志框架，Iris 是 Go 语言的 Web 框架，它本身不提供日志脱敏能力 —— 日志脱敏必须落在你选用的日志库上，比如 zerolog、logrus 或 zap。
为什么 Iris 没有内置日志脱敏？
Iris 的设计哲学是「专注 HTTP 层」：路由、中间件、请求解析、响应写入。它默认用 iris.Logger() 封装了标准库 log，但这个封装只做基础格式化，不介入内容过滤。敏感字段（如手机号、身份证）若直接拼进日志字符串，或通过结构体打印（fmt.Sprintf("%+v", user)），Iris 不会自动识别、更不会打码。
常见错误现象：ctx.Log().Info("user login", "phone", user.Phone, "ip", ctx.RemoteIP()) 输出明文 phone=13812345678；或 ctx.Log().Info("req", "body", ctx.FormValue("json")) 把原始 JSON 全量打出来，里面含身份证字段。
根本原因：Iris 的日志接口是 key-value 形式（类似 Zap 的 With），但它的 Logger 实现不拦截 value 值做正则替换或结构遍历 —— 这属于日志后端（backend）职责，不是 Web 框架该干的事。
在 Iris 中真正生效的日志脱敏路径
你必须把脱敏逻辑下沉到实际使用的日志库中。以当前最常用的 zerolog 为例（Iris 官方文档也推荐它替代默认 logger）：
- 不要用
iris.Logger()直接打结构体或原始字符串，改用zerolog.Logger实例，并启用Hook机制 - 写一个
zerolog.Hook，在Run(e *zerolog.Event, level zerolog.Level, msg string)里对e的所有字段做递归检查：遇到phone、idCard、password等 key，就用****替换对应 value - 注意：如果 value 是 struct，需用反射遍历字段名；如果是 map[string]interface{}，可直接 key 匹配；如果是 string，可加正则（如
^1[3-9]\d{9}$）做二次校验，避免误伤 - 别在 Hook 里做耗时操作（如调外部服务、加锁），否则拖慢整个请求链路；脱敏逻辑必须是纯内存、无副作用的
示例关键片段：
func NewMaskingHook() zerolog.Hook {
return zerolog.HookFunc(func(e *zerolog.Event, level zerolog.Level, msg string) {
maskSensitiveFields(e)
})
}
func maskSensitiveFields(e *zerolog.Event) {
// 遍历 e.Fields() 获取所有 field，对值做脱敏
// 注意：zerolog 内部字段存储为 []interface{}，需按类型断言处理
}
别踩这些坑
容易被忽略的点：
-
ctx.Request().URL.Query()或ctx.FormValues()返回的 map 默认不会进日志 Hook —— 因为你没显式传给 logger。必须手动提取、判断、再传：log.Info().Str("phone", maskPhone(q.Get("phone"))).Msg("login") - 第三方中间件（如 JWT 验证、OAuth2）内部打的日志，完全绕过你的 Hook。要么替换其 logger，要么用
os.Stderr重定向后做行级过滤（不推荐，性能差且不可靠） - 使用
fmt.Sprintf拼接日志消息时，脱敏已失效 —— 字符串在进 logger 前就定型了。必须改用结构化日志方式，让每个字段独立传递 - 测试环境启用了脱敏，但生产配置漏掉了 Hook 注册，导致上线即泄露。建议把 Hook 初始化放在
main.go全局 logger 构建处，而非某个中间件内
最麻烦的其实是日志来源混杂：Iris 自身日志、HTTP Server 错误、数据库驱动日志、gRPC 客户端日志……它们各自用不同 logger。真要全覆盖，得统一日志库选型 + 全局初始化 + 所有依赖强制注入同一 logger 实例。
