beego.SetLogger不生效的根本原因是调用时机错误——必须在beego.Run()之前且晚于beego.BeeApp初始化(app.conf加载完成)执行,若在router注册后或controller中调用会被重置为默认console logger。

Beego 默认会输出 console 日志,但生产环境必须显式配置文件输出,否则日志全丢在终端里,进程一重启就清空。
beego.SetLogger 为什么总不生效
根本原因是调用时机错——beego.SetLogger 必须在 beego.Run() 之前、且晚于 beego.BeeApp 初始化(即 conf/app.conf 加载完成)之后执行。常见错误包括:
- 在
init()函数里调用,但早于beego.BeeApp构建,app.conf还没读,配置被忽略 - 放在
router.go里注册路由之后,或写在某个Controller的Prepare()中,此时 Beego 已内部重置为默认consolelogger - 混用
logs.SetLogger和beego.SetLogger:二者都操作底层logs.BeeLogger,后调用者会覆盖前者的输出目标
file adapter 不轮转?磁盘爆满风险极高
直接传 {"filename":"logs/app.log"} 是单文件无限追加,Beego 默认的 file adapter 不带滚动能力。正确做法只有两种:
- 启用
daily轮转:必须同时指定"daily":true和"maxdays":7,缺一不可;否则既不切分也不清理旧日志 - 改用
multifile:更推荐,专为时间切分设计,配置"datefmt":"2006-01-02"会生成app.2026-10-20.log这类文件,注意"filename":"logs/app"不能带.log后缀 - 确保
logs/目录存在且进程有写权限,否则静默失败(无报错,日志直接丢弃)
如何让 MySQL 和 Cache 模块写不同日志文件
Beego 全局 logger 是单实例,不支持多目标分流。但可以手动创建命名 logger 并注册:
- 在
main.go初始化阶段,用beego.NewLogger("file", ...)创建独立 logger 实例 - 调用
beego.RegisterLogger("mysql", mysqlLogger)注册为命名 logger - 业务代码中通过
l := beego.GetBeeLogger().GetLogger("mysql")获取并使用,如l.Info() - 注意:命名 logger 不受
beego.SetLevel()控制,需单独调用mysqlLogger.SetLevel(beego.LevelDebug)
JSON 格式日志怎么输出
Beego 原生不支持 JSON 输出:file 和 console adapter 固定为文本行格式。硬拼 JSON 字符串会导致时间戳、级别字段重复,且无法被 Filebeat、Loki 等采集器解析。可行方案只有两个:
- 自定义 adapter:实现
beego.LoggerInterface,在WriteMsg()中构造完整 JSON 对象(含level、time、msg、file、line等字段),再用beego.SetLogger注入 - 绕过 Beego 日志层,用标准库
encoding/json手写日志写入逻辑(适合访问日志等固定结构场景)
别漏掉 logs.Reset():否则 console 输出器还在,日志会重复打印两份;也别指望 conf/app.conf 里的 loglevel 控制文件输出——它只影响 console 日志级别,对文件日志完全无效。











