Logrus需显式配置SetLevel和SetOutput，否则日志静默丢失；写文件须避免init中提前关闭句柄；JSON字段失效多因类型非法或钩子误删data；TextFormatter乱码源于ForceColors与DisableColors冲突。
Logrus 不是开箱即用的“零配置”日志库，不显式设置 SetLevel 和 SetOutput，90% 的情况会静默丢日志——不是没打，是你根本看不到。
为什么设置了 logrus.SetLevel(logrus.DebugLevel) 却没有 Debug 日志？
常见错误是只调了 SetLevel，却忘了 SetOutput 仍指向默认的 os.Stderr，而该输出目标可能被重定向、关闭，或压根没连上终端（比如容器里 stdout 被截断）。
- 检查是否在
SetLevel后立刻执行了logrus.Debug("test")，并确认终端/日志采集器能接收 stderr - 若用了自定义
logrus.Logger实例（如l := logrus.New()），必须对l调用l.SetLevel()和l.SetOutput()，logrus.SetLevel()对它无效 - 测试时加一句
fmt.Printf("output: %v\n", logrus.StandardLogger().Out)，确认输出目标不是ioutil.Discard或已关闭的*os.File
怎么把日志写进文件而不报 write testlogrus.log: bad file descriptor？
根本原因是文件句柄在程序启动早期就被关掉了，最典型的是在 init() 函数里用 defer f.Close() —— defer 在 init() 返回时就执行，后续所有日志写入都失败。
- 必须在
main()中打开文件，并用defer f.Close()确保它活到程序退出 - 打开时务必带上
os.O_APPEND | os.O_CREATE | os.O_WRONLY，否则路径不存在或权限不足会导致Write失败且静默丢日志 - 别直接传
*os.File给SetOutput，推荐封装一层：logrus.SetOutput(&lumberjack.Logger{Filename: "app.log", MaxSize: 100, MaxBackups: 5})（用gopkg.in/natefinch/lumberjack.v2更稳妥）
JSON 格式日志字段突然消失，WithFields 不生效？
字段值类型不合法或被中间件吞掉是最常见原因。Logrus 不做深度校验，而是静默跳过整个字段。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 禁止传
map[interface{}]interface{}、chan、func、含循环引用的 struct；nil指针会输出为null，想跳过得提前判空 - 字段名别用点号或空格（如
"user.id"），Loki、Fluent Bit 等采集器解析时会截断 - 如果用了
AddHook()，检查钩子是否误删了entry.Data，尤其清洗字段逻辑里写了entry.Data = make(logrus.Fields)这类覆盖操作 - 永远用字面量构造字段：
log.WithFields(logrus.Fields{"uid": u.ID, "action": "login"})，别复用外部 map 变量，避免 goroutine 间数据竞争
TextFormatter 为什么在 CI 里输出乱码？
不是颜色没关掉，是 ForceColors 和 DisableColors 冲突，或者环境检测失效。
- 绝对不要同时设
ForceColors: true和DisableColors: true，logrus 不校验，但 ANSI 序列会照常输出，导致日志文件里全是\x1b[36m类乱码 - CI/CD 流水线中显式设
DisableColors: true+ForceFormatting: true，绕过 TTY 自动检测 - 更彻底的方案：生产环境直接换
logrus.JSONFormatter{TimestampFormat: "2006-01-02T15:04:05Z"}，它不依赖终端能力，字段顺序稳定，也省去颜色适配麻烦
最难排查的问题往往藏在看不见的地方：hook 内部 panic 被吞、formatter 对 error 字段调用 Error() 方法触发副作用、异步 writer 的 goroutine 泄漏——这些都不会报错，只会让日志变少或延迟出现。
