如何在 Go 应用中实现日志文件的追加写入（而非覆盖）-Golang-PHP中文网

如何在 Go 应用中实现日志文件的追加写入（而非覆盖）

本文详解如何使用 go-logging 库配合 os.OpenFile 正确配置日志后端，使每次程序重启后新日志自动追加到已有日志文件末尾，避免覆盖丢失历史记录。核心在于使用 os.O_APPEND | os.O_WRONLY | os.O_CREATE 标志安全打开文件。

本文详解如何使用 `go-logging` 库配合 `os.openfile` 正确配置日志后端，使每次程序重启后新日志自动追加到已有日志文件末尾，避免覆盖丢失历史记录。核心在于使用 `os.o_append | os.o_wronly | os.o_create` 标志安全打开文件。

在 Go 中使用 github.com/op/go-logging 时，默认调用 os.Create() 会截断（truncate）已有文件，导致每次应用重启后日志从头开始写入——这正是你遇到的问题根源。而 os.Create(filename) 等价于 os.OpenFile(filename, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0666)，其中 os.O_TRUNC 是罪魁祸首。

✅ 正确做法是：统一使用 os.OpenFile 并显式指定安全标志位，跳过 os.Stat + if-else 的竞态逻辑（该方式存在时间窗口漏洞：文件可能在 Stat 后、Create 前被其他进程删除或修改）。

✅ 推荐实现（修复 `InitLog` 函数）

将 utils/appUtils.go 中的 InitLog 函数替换为以下代码：

func InitLog(config LOG) {
    // 使用 O_APPEND | O_WRONLY | O_CREATE 实现“存在则追加，不存在则创建”
    f, err := os.OpenFile(config.LogFile, os.O_WRONLY|os.O_APPEND|os.O_CREATE, 0600)
    if err != nil {
        // 降级处理：若无法打开日志文件，至少向 stderr 输出错误（避免静默失败）
        fmt.Fprintf(os.Stderr, "Failed to open log file %s: %v\n", config.LogFile, err)
        return
    }
    defer f.Close() // 注意：此处 defer 不影响 logging 后端生命周期（f 将被 backend 持有）

    backend := logging.NewLogBackend(f, "", 0)
    format := logging.MustStringFormatter(config.FORMAT)
    backendFormatter := logging.NewBackendFormatter(backend, format)

    logging.SetBackend(backendFormatter)

    level, err := logging.LogLevel(config.LEVEL)
    if err != nil {
        logging.SetLevel(logging.ERROR, "")
    } else {
        logging.SetLevel(level, "")
    }
}

⚠️ 关键说明与注意事项

defer f.Close() 的位置需谨慎：logging.NewLogBackend(f, ...) 内部会持有 f 的引用并自行管理其生命周期（通常不关闭），因此 defer f.Close() 在此属于冗余甚至危险操作（可能导致 backend 后续写入 panic）。✅ 应移除该 defer，由 logging 库负责关闭（它会在程序退出时调用 Close()）；若需手动控制，可参考库文档使用 backend.Close()。
权限掩码 0600 合理：确保日志文件仅当前用户可读写，符合安全最佳实践。
无需判断文件是否存在：os.O_CREATE 保证文件不存在时自动创建，os.O_APPEND 保证所有写入均发生在文件末尾，二者组合完全满足需求。
避免变量遮蔽（shadowing）：原尝试中 f, err := ... 在 if/else 内部重新声明，导致外部 f 未被赋值——这是常见陷阱，Go 1.22+ 已加强警告，务必统一用 var f *os.File + 单次赋值。

? 补充建议：按日期轮转（可选进阶）

若长期运行需防止单个日志文件过大，建议后续集成轮转方案，例如：

使用 lumberjack（轻量、稳定、广泛采用）：

import "gopkg.in/natefinch/lumberjack.v2"
// ...
f := &lumberjack.Logger{
    Filename:   config.LogFile,
    MaxSize:    100, // MB
    MaxBackups: 3,
    MaxAge:     28,  // days
    Compress:   true,
}
backend := logging.NewLogBackend(f, "", 0)