Beego logs模块默认同步写入,需显式调用log.Async()开启异步模式,该操作设置asynchronous=true并初始化msgChan;仅NewLogger传入channel size不启用异步,且必须调用Close()确保消息不丢失。

Beego 的 logs 模块默认是同步写入的,异步需显式启用;多输出通道不是“自动叠加”,而是靠多次调用 SetLogger 手动注册,且各通道独立控制等级和配置。
如何开启日志异步模式并避免消息丢失
异步模式本质是启动一个 goroutine 从 msgChan 消费日志,但默认不启用。关键点在于:NewLogger 的参数只设缓冲区大小,不触发异步;必须手动设置 asynchronous 标志。
- 创建 logger 后立即调用
log.Async()—— 这才是开启异步的正确方式,它内部会设置asynchronous = true并初始化msgChan - 若跳过
Async()直接调用SetLogger,即使 channel size > 0,仍为同步写入(WriteMsg直接执行,不走 channel) - 异步下务必调用
Close():否则signalChan 不会被消费,wg.Wait()会永久阻塞,进程无法优雅退出 - 缓冲区满时,默认行为是丢弃新日志(无阻塞写入),如需背压,得自己封装带超时的
select写入逻辑
同时输出到 console 和 file 的实操配置
Beego 不支持单次配置多个 adapter,必须分两次 SetLogger 注册,且注意顺序和等级继承关系。
- 先调用
logs.SetLogger("console"),再调用logs.SetLogger(logs.AdapterFile, `{"filename":"app.log"}`) - 两个通道共享同一个全局 level(由
logs.SetLevel()控制),但 file adapter 可在 JSON 配置里单独指定"level"字段覆盖——该字段仅对当前 adapter 生效 - console 默认彩色输出,file 默认不带颜色;若 file 配置中加
"color":true,实际无效(fileadapter 忽略该字段) - 若想让 console 只输出 error+,file 输出 debug+,只能拆成两个独立
BeeLogger实例,分别调用SetLevel
file adapter 轮转与权限问题排查
使用 logs.AdapterFile 时,常见错误不是配置写错,而是运行时环境缺失。
-
"daily": true表示按天切分,但不会自动创建目录;若"filename": "logs/app.log",需确保logs/目录存在且进程有写权限,否则首次写入即 panic -
"maxsize"单位是字节,不是 MB;设"maxsize": 10485760才是 10MB,设成10就会每 10 字节切一次文件 -
"maxdays": 7仅清理旧日志文件,不阻止当日文件无限增长;需配合"maxsize"或"maxlines"使用 - Windows 下路径分隔符用
/或\均可,但 JSON 字符串中需双写为\,否则解析失败报invalid character '\'
自定义 adapter 与 nameLogger 的命名冲突
Beego 允许注册自定义 adapter,但名字不能和内置的 console、file 等重复,且注册后无法覆盖。
- 调用
logs.SetLogger("myadapter", config)前,需确认adapters["myadapter"]已通过logs.Register注册,否则返回"unknown adapter"错误 - 同一 name 多次调用
SetLogger会报"duplicate adaptername";如需热更新配置,必须先DelLogger("myadapter"),再重新SetLogger -
DelLogger只删除实例,不释放已打开的文件句柄;若删了 file adapter 但没 close 底层*os.File,会导致文件被占用无法删除 - 所有 adapter 实例都存于
BeeLogger.outputs切片,遍历时顺序即日志输出顺序;console 在前,file 在后,则同一条日志先打屏再落盘
最易被忽略的是:异步模式下,Close() 必须在程序退出前调用,且不能依赖 defer(主 goroutine 退出后,async goroutine 可能还在跑);多通道时,每个 adapter 的配置字段语义不一致,比如 color 对 console 有效、对 file 无效,得查源码确认,不能凭经验猜。











