通八洲科技

Seelog 日期滚动文件名格式问题解析与替代方案

日期:2025-12-26 00:00 / 作者:碧海醫心

seelog 的日期滚动文件名格式实际生成的文件名为 `filename.时间戳`(如 `-myapp.log.142711`),而非文档声称的 `时间戳+filename`(如 `142711-myapp.log`);这是因官方文档过时所致,当前版本不支持自定义文件名拼接顺序。

在使用 Seelog 进行日志归档时,开发者常期望通过 实现类似 142711-myApp.log 的命名效果(即日期前缀 + 自定义文件名)。然而,实际行为是将时间戳后缀追加到原始 filename 之后,生成形如 /tmp/-myApp.log.142711 的文件——这与 Seelog Wiki 文档 中描述的 "time.Now().Format(...) + filename" 行为完全相反。

该不一致已被社区确认为文档陈旧导致的误导。GitHub Issue #71 中明确指出:当前实现始终采用 filename + "." + timestamp 拼接逻辑,且无配置项可反转顺序;官方亦未提供补丁或计划在短期内修复此行为。

可行替代方案如下:

  1. 调整 filename 值以“模拟”前缀效果
    虽无法真正前置日期,但可通过在 filename 中预留占位符并配合脚本重命名实现近似效果:

    启动后,文件仍为 /tmp/_DATE_PLACEHOLDER_-myApp.log.142711,再借助外部定时任务(如 find /tmp -name "*-myApp.log.*" -exec bash -c 'f={}; mv "$f" "${f/_DATE_PLACEHOLDER_/$(basename "$f" .log | cut -d. -f2)}"' \;)批量重命名为 142711-myApp.log。

  2. 迁移到维护更活跃的日志库(推荐)
    Seelog 自 2017 年起已停止维护,建议升级至 Zap 或 Logrus(配合 lumberjack):

    // 使用 lumberjack(Logrus 示例)
    log.SetOutput(&lumberjack.Logger{
        Filename:   "/tmp/myApp.log",
        MaxSize:    100, // MB
        MaxBackups: 5,
        MaxAge:     28,  // days
        LocalTime:  true,
        Compress:   false,
    })
    // 生成 /tmp/myApp.log.20250315 (日期后缀),再通过符号链接或启动脚本软链为 /tmp/20250315-myApp.log

⚠️ 注意事项:

综上,该问题本质是历史项目文档与实现脱节所致,无原生配置解法。生产环境强烈建议迁移至 Zap 或 Logrus + lumberjack 组合,以获得准确可控的滚动策略与长期维护保障。