Golang logrus日志框架如何用_Golang logrus教程【秒懂】-Golang-PHP中文网

logrus.withfields要求key必须为string，非字符串key会导致panic；setlevel需配合setoutput使用，否则可能静默丢日志；disablecolors与forcecolors不可同时设置；witherror保留error原始信息，优于直接传err。

golang logrus日志框架如何用_golang logrus教程【秒懂】

logrus.WithFields 传 map[string]interface{} 时 key 必须是 string

logrus 不接受非字符串类型的 key，比如 int、bool 或结构体字段名直接当 key（如 user.ID），否则 panic：panic: reflect: call of reflect.Value.Type on zero Value。

常见错误是把 struct 直接塞进 logrus.Fields，误以为会自动展开字段名：

log.WithFields(logrus.Fields{user: user}).Info("user info") // ❌ user 是变量名，不是字符串 key

正确做法是显式写出字段名和值：

用 map[string]interface{} 手动构造，key 全是 string
避免用 fmt.Sprintf 拼 key，容易漏引号或类型错位
如果要打 struct 全字段，先用 json.Marshal 转成字符串再塞进去，别强求自动反射

logrus.SetLevel 后日志不输出？检查是否调用了 SetOutput

logrus 默认只输出到 os.Stderr，但如果你改过 SetOutput（比如重定向到文件或 ioutil.Discard），又没同步处理 level，就会“静默丢日志”——没报错，也没输出。

典型场景：测试环境想关掉 debug 日志，只保留 error，结果发现 info 也不见了：

log.SetLevel(logrus.ErrorLevel)
log.SetOutput(ioutil.Discard) // ❌ 这行让所有日志都丢了，和 level 无关

解决方法很简单：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

SetOutput 和 SetLevel 是两个独立开关，必须都配对检查
调试时加一句 log.Out == os.Stderr 判断输出目标是否正常
生产环境写文件时，记得用 os.OpenFile 带 os.O_APPEND | os.O_CREATE，否则可能因权限或路径问题导致 Write 失败而静默丢日志

logrus.TextFormatter 的 DisableColors 和 ForceColors 冲突吗？

会。如果终端不支持颜色（比如 CI 环境或重定向到文件），DisableColors: true 生效；但一旦设了 ForceColors: true，logrus 就强行加 ANSI 转义符，不管终端能不能渲染。

后果是：日志文件里出现一堆 \x1b[36m 类乱码，或者某些日志系统解析失败。

建议按场景选：

本地开发：留空，靠自动检测
CI/CD 流水线：显式设 DisableColors: true，别碰 ForceColors
强制彩色（如 k8s pod 日志看板）：只设 ForceColors: true，且确保下游能解码
别同时设两者，logrus 不校验，但行为不可控

logrus.WithError(err) 和 log.Error(err) 有什么区别？

WithError 是给日志加一个叫 error 的 field，类型是 error，最终序列化时会调用 err.Error()；而 log.Error(err) 是把 err 当作普通参数传给 Sprintf，等价于 log.Error(err.Error()) —— 它丢失了原始 error 类型信息，比如 stack trace、wrapped error 都没了。

更关键的是：很多 logrus hook（比如 sentry、elastic）只认 WithError 注入的 error 字段，才能自动提取堆栈和上下文。

用 log.WithError(err).Warn("failed to fetch user") ✅
别用 log.Warn(err) 或 log.Warn(err.Error()) ❌
如果 err 是 nil，WithError(nil) 会忽略，安全；但 log.Error(nil) 会打出 <nil></nil> 字符串，污染日志

字段名固定是 error，不能改；想加多个 error？只能自己命名，比如 db_error、http_error。