如何使用Golang实现日志文件轮转_Golang log包与io操作技巧_网络技术

log.SetOutput不能直接接*os.File实现轮转，因标准文件不支持自动切换，需自定义io.Writer封装轮转逻辑，含大小监控、原子替换、并发锁及过期检测。

因为 log.SetOutput 接收的是 io.Writer，而轮转需要在写入前判断文件大小或时间，标准 *os.File 不具备自动切换能力。直接传入一个固定文件句柄，日志永远只写进同一个文件，轮转逻辑必须自己控制写入时机和目标。

常见错误现象：调用 os.OpenFile 时用了 os.O_APPEND 但没关旧文件，导致 fd 泄露；或轮转后仍往旧 *os.File 写，新日志进了老文件。

轮转不是“换文件名”，而是“换 io.Writer 实例”
每次写日志前需检查是否触发轮转条件（大小/时间），是则先 Close() 旧文件、再 OpenFile() 新文件、再更新 log.SetOutput()
必须加锁（sync.Mutex），否则并发写日志时可能多个 goroutine 同时触发轮转，造成文件覆盖或 panic

可以，但不解决轮转问题 —— io.MultiWriter 只是把一份日志同时写进多个 io.Writer，它本身不感知文件生命周期。若其中一个 writer 是轮转中的文件，你仍得自己管理那个 writer 的切换。

典型使用场景：调试阶段既要看到终端输出，又要保留完整日志到磁盘，且磁盘部分需轮转。

logger := log.New(io.MultiWriter(fileWriter, os.Stdout), "", log.LstdFlags)
// fileWriter 必须是封装好的、支持轮转的 io.Writer 类型，不是裸 *os.File

核心是拦截每次写入，检查当前文件大小，超限时新建文件并重置计数器。不能依赖 os.Stat() 频繁查大小（有 syscall 开销），推荐在每次 Write() 后更新内存中记录的 size。

容易踩的坑：用 os.Stat().Size 判断是否轮转，但该值可能滞后（缓冲未刷盘）；或轮转时未同步更新内部 size 计数器，导致下一次写入立刻又触发轮转。

用自定义 struct 包裹 *os.File，实现 io.Writer 接口，并维护 curSize int64
每次 Write(p []byte) 后执行 w.curSize += int64(len(p))，再判断是否 >= maxSize
轮转函数内必须：oldFile.Close() → newFile := os.OpenFile(...) → w.file = newFile → w.curSize = 0
注意 Windows 下重命名正在写的文件会失败，建议生成带时间戳的新文件名（如 app.log.202505201530），而非 app.log.1

必须在确认所有 goroutine 都不再写入旧 writer 后才能 Close()。由于 log.Logger 是无锁写入，替换 SetOutput 瞬间就生效，但正在执行的 logger.Print() 可能还在用旧 writer。

所以不能在轮转函数里直接 oldFile.Close()，而应延迟到「确保无进行中写入」之后 —— 最稳妥方式是：用 channel 或 sync.WaitGroup 协调，或更简单：让 writer 自己在 Write() 中检测是否已被弃用。

轮转看似只是“换文件”，实际涉及写入原子性、fd 生命周期、并发安全三重边界。最易被忽略的是：writer 替换与文件关闭之间存在微小时间窗口，这个窗口里旧文件仍可能被写入 —— 所以 writer 必须自带过期判断，而不是依赖外部调度。