Beego 默认日志同步阻塞,高并发需先 SetLogger 再 Async(n),配 daily+maxdays+maxsize 防丢日志和误删;禁用 EnableFuncCallDepth 减少 CPU 开销;归档压缩清理须由 logrotate 等外部工具完成。

Beego 默认日志写入是同步阻塞的,直接用于海量日志场景(如每秒千级日志行)会导致 goroutine 卡在 Write 调用上,拖慢业务响应甚至引发超时。必须启用异步模式,并配合文件引擎的合理配置,否则只是“假异步”。
beego/logs.Async() 必须在 SetLogger 之后调用
顺序错误会导致异步开关失效,日志仍走同步路径。常见错误写法是先 Async() 再 SetLogger(),此时 Async() 没有作用对象,被忽略。
- 正确顺序:先
logs.SetLogger(logs.AdapterFile, config),再logs.Async(1e4) -
Async()参数是缓冲 channel 容量,1e4 是较安全起点;低于 1000 在高并发下容易丢日志(channel full 后Println会阻塞或 panic,取决于是否设了Drop行为) - 不传参数默认是 1e6,看似保险,但内存占用不可控,尤其在低配容器中易触发 OOM
file 引擎的 daily + maxdays 配合异步才真正有效
只开 daily: true 不够——如果异步队列积压未刷盘,旧日志文件可能被轮转逻辑误删,导致归档丢失。
- 必须同时设置
"maxdays": 30(示例值),确保轮转前保留足够天数的文件句柄 -
"maxsize": 104857600(100MB)建议显式指定,避免单文件过大影响归档切割和下游处理 - 注意:
"daily"和"maxsize"是“或”关系触发轮转,不是“且”。只要任一条件满足就切新文件 - 轮转期间,异步 writer 仍在往旧文件写,file 引擎内部会自动把后续日志导向新文件,无需手动干预
EnableFuncCallDepth(true) 在异步模式下会显著增加 CPU 开销
开启文件名/行号后,每次日志调用都要执行 runtime.Caller(),而异步模式下该调用发生在业务 goroutine 中(非 writer goroutine),高频调用会明显抬升 CPU 使用率。
- 生产环境建议关闭:
logs.EnableFuncCallDepth(false) - 如需定位问题,改用日志内容里加 traceID 或用中间件统一注入
req_id,比动态 Caller 更轻量 - 若坚持要行号,务必确认
SetLogFuncCallDepth()值准确——默认 2,但如果你封装了 log 工具函数,需设为 3 或 4,否则打出来的永远是工具函数自己的位置
归档后的文件压缩与清理不能依赖 beego 自身
beego/logs 只负责写和轮转,不提供 zip/gzip 压缩、rsync 推送、过期清理等归档动作。这些必须由外部进程或定时任务接管。
- 推荐用
logrotate配合postrotate脚本:压缩 + mv 到归档目录 + 清理本地旧文件 - 避免在 Go 进程内用
os.Rename+exec.Command("gzip")—— 异步日志 writer 可能正写入该文件,导致压缩不完整或 panic - 注意文件权限:beego 进程用户需对归档目录有写权限,
logrotate的create指令要匹配该用户
最易被忽略的是异步缓冲区与磁盘 I/O 的节奏错位:writer goroutine 每次从 channel 取一批日志批量写入,但若磁盘慢(如 NFS、低配云盘),buffer 积压速度超过消费速度,channel 就会满。这时要么丢日志,要么阻塞业务——没有银弹,只能靠压测确定 Async(n) 的 n 值,并监控 logs.GetLogger().GetLevel() 对应的 drop 计数。


















