logrus 默认不滚动因其仅提供日志格式化与输出接口,无内置轮转逻辑;go-logging 同样仅支持 stdout/stderr 输出,需手动集成 lumberjack 等 io.WriteCloser 实现文件滚动。

为什么 logrus 默认不滚动,而 go-logging 又不直接支持文件输出
Go 标准库 log 和主流第三方日志库(如 logrus、zap)本身不内置滚动逻辑;go-logging 是一个轻量级、可组合的日志库,但它默认只提供 Stdout 和 Stderr 输出,没有开箱即用的文件滚动能力。你得自己拼接 io.Writer + 滚动逻辑。
常见错误是直接传一个固定 *os.File 给 go-logging 的 FileHandler(它其实不存在),结果日志写满磁盘或单文件暴涨到 GB 级别才意识到没滚动。
- 滚动必须靠外部轮子,比如
gopkg.in/natefinch/lumberjack.v2 -
go-logging的核心是logging.Logger+logging.Backend,后者需要一个io.Writer - 所以真正要做的,是把
lumberjack.Logger当作io.Writer传给go-logging的 backend
怎么用 lumberjack 配合 go-logging 实现按大小+日期滚动
lumberjack 是最常用、稳定、参数清晰的 Go 日志滚动方案。它本身实现了 io.WriteCloser,可直接作为 go-logging 的后端 writer。
关键配置项注意:MaxSize 单位是 MB(不是字节),MaxBackups 是保留几个历史文件,MaxAge 是按天算的过期时间——三者共同作用,不是互斥。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
import (
"gopkg.in/ogier/pure-go-logging.v1"
"gopkg.in/natefinch/lumberjack.v2"
)
func setupLogger() *logging.Logger {
lumberjack := &lumberjack.Logger{
Filename: "./logs/app.log",
MaxSize: 10, // MB
MaxBackups: 5,
MaxAge: 7, // days
Compress: true,
}
backend := logging.NewLogBackend(lumberjack, "", 0)
backend.SetLevel(logging.INFO)
logger := logging.NewLogger("app")
logger.SetBackend(backend)
return logger
}
- 路径
"./logs/app.log"会自动创建目录,但父目录需存在(logs/不会自动mkdir -p) -
Compress: true仅对归档后的.log.1.gz生效,当前活跃日志仍是纯文本 - 如果同时设了
MaxBackups: 3和MaxAge: 1,可能某天只留 1 个备份(取更严条件)
如何避免多进程写同一个 lumberjack 文件导致损坏
Go 进程间不共享文件句柄,lumberjack 也不是为多进程设计的。如果你用 supervisor、systemd 启多个实例,或 fork 出子进程,都可能触发并发写入,表现为日志错乱、gzip 解压失败、甚至 lumberjack panic 报错 write /path/app.log: bad file descriptor。
- 单机多实例场景下,必须为每个进程生成唯一日志名,例如加 PID 或服务名前缀:
fmt.Sprintf("./logs/app-%d.log", os.Getpid()) - 不要依赖
lumberjack自动处理进程竞争,它没有 flock - 若必须集中日志,改用 syslog 协议或写入 Kafka/Fluentd,而不是让多个 Go 进程直写同一文件
go-logging 的 level 和 lumberjack 的写入性能有关系吗
没有。日志级别过滤发生在 go-logging 的 Logger 层,过滤完才调用 Write();lumberjack 只负责接收已过滤后的字节流并落盘。所以关掉 DEBUG 能显著减少写入量,但不会改变 lumberjack 单次 write 的耗时。
- 高频小日志(如每毫秒一条)建议开启
lumberjack的LocalTime: true,避免时区转换开销 - 如果发现写日志卡主 goroutine,检查是否忘了设
lumberjack的BufferSize(默认 64KB),小 buffer 在高吞吐下会频繁 flush -
go-logging本身无异步队列,重度使用建议套一层chan []byte+ worker,但那就脱离了它“轻量”的初衷
滚动日志真正的复杂点不在配置,而在确认你的部署方式是否允许多进程写同一文件,以及是否在容器中忘了挂载日志目录。这两处一错,滚动就形同虚设。

















