Beego默认logs模块不支持自动轮转，必须集成lumberjack等第三方轮转写入器并显式配置maxsize、daily等参数，同时启用Async、SetLevel和SetLogFuncCall三项关键设置，多实例部署需确保日志路径唯一。
Beego 默认的日志模块（logs）不支持自动按大小或时间轮转分割，直接写入单个文件会导致日志膨胀、排查困难、磁盘占满等生产问题。必须手动集成第三方日志库或启用 Beego 的 file 日志适配器并配置轮转参数，否则无法满足基础运维要求。
Beego 内置 logs 模块的轮转能力限制
Beego v2.x 的 logs 包虽提供 SetLogger 接口，但其内置的 file 类型仅支持基础路径写入，不原生支持按大小切割（如 100MB 后新建）或按日期归档（如 app.log.2026-08-21）。常见错误是误以为调用 logs.SetLogger("file", `{"filename":"logs/app.log"}`) 就能自动轮转——实际只会一直追加到同一个文件。
关键参数缺失示例：
{
"filename": "logs/app.log",
"maxlines": 1000000,
"maxsize": 104857600,
"daily": true,
"maxdays": 7,
"rotate": true
}
⚠️ 注意：maxlines/maxsize/daily 等字段在 Beego 原生 file 驱动中被忽略，除非你使用的是社区补丁版或自行重写 FileWriter。
用 github.com/astaxie/beego/v2/logs + 自定义 RotateWriter
官方推荐路径是升级到 Beego v2 并搭配其维护的 logs 子模块，但需手动注入支持轮转的 Writer。最轻量可行方案是封装一个兼容 logs.BeeLogger 接口的轮转写入器：
- 用
gopkg.in/natefinch/lumberjack.v2作为底层轮转引擎（稳定、无依赖、支持MaxSize/MaxAge/MaxBackups） - 包装成
logs.Adapter实现，覆盖Write方法，把日志内容透传给lumberjack.Logger - 初始化时通过
logs.SetLogger("file", configJSON)注入，其中configJSON只保留filename字段，其余轮转逻辑由自定义 Writer 控制
典型初始化代码片段：
import (
"github.com/astaxie/beego/v2/logs"
"gopkg.in/natefinch/lumberjack.v2"
)
func init() {
lw := &lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 100, // MB
MaxBackups: 30,
MaxAge: 28, // days
}
logs.SetLogger("file", fmt.Sprintf(`{"filename":"%s"}`, lw.Filename))
// 替换 Writer
logs.GetBeeLogger().SetWriter(lw)
}
生产环境必须开启的 3 个日志配置项
绕过轮转缺陷后，仍需强制设置以下三项，否则日志可读性与可追溯性会严重下降：
-
logs.Async(true)：启用异步写入，避免高并发日志阻塞请求处理 goroutine；但注意内存缓冲默认 1MB，突发日志可能丢数据，建议配合BufferLen调整 -
logs.SetLevel(logs.LevelInformation)：禁用LevelDebug上线环境，避免敏感变量（如 SQL 参数、token）泄露；错误日志必须至少保留LevelError -
logs.SetLogFuncCall(true)：开启函数调用栈记录，定位models.User.Save这类深层调用位置；但会增加约 15% 性能开销，仅在 debug 或灰度环境启用
特别注意：SetLogFuncCall 在 Beego v2 中默认关闭，且不会出现在任何配置文件里，必须在代码中显式调用才生效。
多实例部署时的日志路径冲突风险
当 Beego 应用以多进程（如 supervisor 启动多个 bee run 实例）或容器化（K8s 多 Pod）方式运行时，若所有实例共用同一 filename，会出现：
- 文件句柄竞争，部分日志丢失或写入错乱
- 轮转触发时机不一致，导致备份文件名重复（如两个进程同时生成
app.log.2026-08-21）
解决方式不是加锁，而是让每个实例日志路径唯一：
- 容器场景：用
HOSTNAME环境变量拼接路径，如logs/app-${HOSTNAME}.log - 进程场景：用
os.Getpid()生成后缀，如app.log.pid12345 - 绝对禁止在配置中硬编码固定路径，也不依赖 Beego 的
AppConfig.String("log::filename")直接取值
真正容易被忽略的点是：轮转逻辑本身不感知进程隔离，lumberjack 的 MaxBackups 是按单个文件计数，多实例共用路径时备份总数会翻倍，快速耗尽磁盘空间。
