Golang 文件写入失败的常见原因及解决方案-Golang-PHP中文网

Golang 文件写入失败的常见原因及解决方案

go 程序中日志未写入文件，主因是主 goroutine 过早退出导致程序终止，且日志通道未关闭，致使消费者 goroutine 无限阻塞；同时存在文件打开模式错误与资源竞争隐患。

go 程序中日志未写入文件，主因是主 goroutine 过早退出导致程序终止，且日志通道未关闭，致使消费者 goroutine 无限阻塞；同时存在文件打开模式错误与资源竞争隐患。

上述代码看似逻辑清晰：主线程创建并关闭初始文件句柄、启动一个日志消费 goroutine 持续从 channel 读取消息并追加写入文件，再并发发送多条日志消息。但实际运行后 log.txt 始终为空。根本问题不在“同步”本身，而在于程序生命周期管理缺失与I/O 操作配置错误。

? 核心问题解析

主 goroutine 提前退出（致命）
main() 函数在启动所有 worker goroutine 后立即结束，Go 运行时会强制终止整个进程——无论其他 goroutine 是否仍在执行。因此，日志消费协程甚至来不及处理第一条消息就被杀死。这是空文件的最直接原因。
channel 未关闭，for range 或 ok 检查失效
消费端使用 msg, ok := 判断通道是否关闭，但 <code>ok 仅在通道被显式 close(logCh) 且已无缓冲数据时才为 false。当前代码从未调用 close(logCh)，导致 for { ... } 死循环阻塞在 上（即使缓冲区为空），无法退出。
文件打开模式错误（潜在崩溃风险）
os.OpenFile("./log.txt", os.O_APPEND, os.ModeAppend) 中，第三个参数应为文件权限掩码（如 0644），而非 os.ModeAppend（它是标志位，非权限）。正确写法是：

Golang Stay Updated
提供最新的 Golang 新闻、社群和值得关注的人。适用于寻找 Go 学习资源、发现新库等。

下载
```
f, err := os.OpenFile("./log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
    panic(err) // 或合理错误处理
}
```
否则可能因权限参数非法导致 f == nil，后续 f.WriteString() 触发 panic（但因主 goroutine 已退出，panic 甚至不会被观察到）。
重复打开/关闭文件，低效且易出错
每次写日志都 OpenFile → WriteString → Close，不仅性能差，还可能因系统文件描述符耗尽或竞态（如多 goroutine 同时写同一文件，虽本例中仅单 consumer，但设计不健壮）。

✅ 正确实现方案（推荐）

package main

import (
    "fmt"
    "os"
    "sync"
    "time"
)

func main() {
    logCh := make(chan string, 50)

    // 启动日志写入 goroutine，并传入 *os.File 避免重复打开
    var wg sync.WaitGroup
    wg.Add(1)
    go func() {
        defer wg.Done()
        f, err := os.OpenFile("./log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
        if err != nil {
            panic("failed to open log file: " + err.Error())
        }
        defer f.Close() // 确保最终关闭

        for msg := range logCh { // 使用 range 自动检测 channel 关闭
            logTime := time.Now().Format(time.RFC3339)
            _, _ = f.WriteString(logTime + " - " + msg) // 忽略写入错误仅作示例，生产环境需检查
        }
    }()

    // 启动计算 goroutine 并发送日志
    for i := 1; i <h3>⚠️ 关键注意事项</h3>