Golang日志写入失败怎么办

在 Go 语言中，日志写入失败通常不是“致命错误”，但必须定位原因并做兜底处理。下面按常见原因 → 排查方法 → 解决方案来说明。

一、常见日志写入失败原因

1. 日志文件无法打开 / 权限不足

f, err := os.OpenFile("app.log", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644)
if err != nil {
    // 常见：权限不足、目录不存在
}

✅ 常见错误：

permission denied
no such file or directory

2. 磁盘空间不足

日志写入时返回 no space left on device
文件写入成功但系统异常

✅ 排查：

df -h

3. 日志文件被删除或移动

文件被 rm 或 logrotate 移动
文件句柄仍存在，但写入异常

✅ 表现：

程序仍在运行
日志不再增长

4. 并发写入冲突

多个 goroutine 同时写同一文件
未加锁或使用非线程安全 logger

✅ 建议：

使用 sync.Mutex
或使用 log.SetOutput + 单 logger 实例

5. 使用第三方日志库配置错误

如 logrus、zap、zerolog：

输出路径错误
hook 失败
buffer 未 flush

二、如何排查日志写入失败

✅ 1. 判断错误是否返回

if err != nil {
    fmt.Println("日志写入失败:", err)
}

⚠️ 注意：

log.Println("xxx") // 默认不返回错误

✅ 2. 使用自定义 Writer 捕获错误

type errorWriter struct {
    w   io.Writer
    err error
}

func (ew *errorWriter) Write(p []byte) (n int, err error) {
    n, err = ew.w.Write(p)
    if err != nil {
        ew.err = err
    }
    return
}

✅ 3. 检查文件句柄状态

f, err := os.Stat("app.log")
fmt.Println(f, err)

三、解决方案与最佳实践

✅ 1. 使用标准库时兜底输出

log.SetOutput(io.MultiWriter(
    logFile,
    os.Stderr,
))

✅ 日志文件失败 → 至少还能看到 stderr

✅ 2. 捕获 panic / fatal 日志

defer func() {
    if r := recover(); r != nil {
        fmt.Println("日志系统异常:", r)
    }
}()

✅ 3. 定期重新打开日志文件（推荐）

func reopenLog() {
    f, err := os.OpenFile("app.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
    if err == nil {
        log.SetOutput(f)
    }
}

✅ 解决 logrotate 问题

✅ 4. 使用成熟日志库（强烈推荐）

logrus

log := logrus.New()
log.SetOutput(os.Stdout)

zap（高性能）

logger, _ := zap.NewProduction()
defer logger.Sync()

四、生产环境建议 ✅

✅ 日志写入失败时的黄金原则：

不能因为日志失败导致主流程崩溃

建议：

日志写入失败 → 降级到 stderr
关键日志 → 回调告警
日志文件目录提前创建
定期 rotate 日志，避免磁盘满

五、快速自检清单 ✅

[ ] 日志目录是否存在
[ ] 是否有权限
[ ] 磁盘是否满
[ ] 是否并发写
[ ] 是否被 logrotate
[ ] 是否 catch 了错误

如果你愿意，可以把具体代码或报错信息贴出来（比如 logrus / zap 使用方式），我可以直接帮你定位问题。