Go Lumberjack LocalTime 为什么不决定日志正文时间格式

如果你给 lumberjack.Logger 设置了 LocalTime: true，却发现日志正文里的时间格式没有变化，这不是配置失效，而是两个时间字段来自不同的组件。Lumberjack 只负责把当前文件改名、创建新文件和清理旧文件；它不会解析或重写写入的字节。

LocalTime 只改变轮转备份文件名

Lumberjack 实现的是 io.WriteCloser，写入路径接收的是一段已经准备好的字节。发生轮转时，它先关闭旧文件，再把旧文件改成类似 server-2026-10-29T10-30-00.000.log 的备份名，然后重新创建原始文件名。LocalTime 只参与这个备份名的时间格式化：为 false 时转为 UTC，为 true 时保留计算机本地时间。

因此，正文中的 2026/10/29 10:30:00、2026-10-29T02:30:00Z 或自定义业务时间，都不是 Lumberjack 产生的。它们在进入 Write 之前已经被标准库 log、Zap、Zerolog 或业务代码写进字节流。

用标准库 log 配置正文时间前缀

最小改法是把 Lumberjack 当作输出目标，把正文格式交给 log.New 的 flags。下面的例子让每行正文带日期、时间和微秒；LocalTime 仍然只服务于轮转备份名。

package main

import (
    "log"

    "gopkg.in/natefinch/lumberjack.v2"
)

func main() {
    writer := &lumberjack.Logger{
        Filename: "/var/log/demo/server.log",
        MaxSize:  100, // 按 100 MB 触发轮转
        LocalTime: true, // 只影响备份文件名中的轮转时间
    }
    defer writer.Close() // 进程退出前关闭当前日志文件

    logger := log.New(writer, "", log.Ldate|log.Ltime|log.Lmicroseconds)
    logger.Println("request accepted") // 正文时间由 log.Logger 添加
}

这段代码生成的正文前缀取决于标准库 flags，而不是 LocalTime。如果需要毫秒、固定时区名称或 RFC3339，标准库的 flags 不够细，就进入下一种方案。

自定义格式时在上层生成时间字段

自定义布局应在写入 Lumberjack 之前完成。可以用一个小的业务日志函数统一时间、等级和消息字段；关键是让 Lumberjack 继续只处理文件生命周期。

package main

import (
    "fmt"
    "io"
    "time"
)

func writeLine(out io.Writer, level, message string) error {
    // 用固定布局生成正文时间；时区应由业务配置明确决定
    stamp := time.Now().In(time.Local).Format("2006-01-02 15:04:05.000 -0700 MST")
    _, err := fmt.Fprintf(out, "%s level=%s msg=%s\n", stamp, level, message)
    return err // 把底层写入错误交给调用方处理
}

生产代码中可以把 time.Local 换成明确的 *time.Location，例如通过 time.LoadLocation 读取部署配置。这样正文时区是业务选择，轮转文件名仍由 LocalTime 独立控制。

轮转参数不要和正文格式混在一起

把配置拆开看，排障会快很多：

还要记住 Lumberjack 假定同一台机器只有一个进程写入这组输出文件。多进程共用同一配置会让轮转结果不可靠；这与时间格式无关，却经常和“文件名时间不对”一起被误判。

时间不一致时按四项清单定位

1. 先看当前文件和备份文件名：只有备份名变化，说明 LocalTime 正常工作。
2. 再看正文前缀：确认是标准库 flags、结构化日志 encoder，还是业务自拼字符串。
3. 检查进程时区：容器、主机和显式 *time.Location 可能不是同一个时区。
4. 最后检查轮转触发时刻：文件名记录的是轮转时间，不一定是该文件最后一行日志的写入时间。

正确的修复通常是“保留 LocalTime 处理备份名，再修改上层 formatter 处理正文”，而不是反复切换这个布尔值。这样轮转策略和日志展示格式各自可测试、可回滚。

常见问题

LocalTime 设为 true 后，正文还显示 UTC，怎么办？

检查正文是否由标准库或结构化日志器生成，并单独配置它的时区或时间编码器；LocalTime 不会改写已经传给 Lumberjack 的字节。

备份文件名的时间能自定义成别的格式吗？

Lumberjack 使用固定的轮转时间格式。若业务必须使用不同文件命名规则，应在外围设计归档或重命名策略，不要把正文 formatter 当成文件轮转器。

MaxAge 是按正文最后一条日志计算的吗？

不是。清理依据是备份文件名中编码的轮转时间，而且一天按 24 小时计算；它可能与该文件最后一次写入时间不同。

参考资料：Lumberjack 官方仓库与 Go 包文档。官方地址：https://github.com/natefinch/lumberjack