Golang 中 bad file descriptor 错误的成因与修复方法-Golang-PHP中文网

Golang 中 bad file descriptor 错误的成因与修复方法

在 Go 中使用 os.OpenFile 以 O_APPEND 模式打开日志文件时，若未显式指定读写权限标志（如 O_WRONLY），会导致系统返回“bad file descriptor”错误——根本原因是 Linux open() 系统调用强制要求 flags 中必须包含 O_RDONLY、O_WRONLY 或 O_RDWR 之一。

在 go 中使用 `os.openfile` 以 `o_append` 模式打开日志文件时，若未显式指定读写权限标志（如 `o_wronly`），会导致系统返回“bad file descriptor”错误——根本原因是 linux `open()` 系统调用强制要求 flags 中必须包含 `o_rdonly`、`o_wronly` 或 `o_rdwr` 之一。

你遇到的 write ./log.log: bad file descriptor 错误，并非源于并发竞争或文件权限问题（666 权限已足够），而是因为 os.OpenFile 的 flag 参数缺失必需的访问模式。Go 的 os.O_APPEND 仅控制写入位置（追加到末尾），它不隐含写入权限；底层调用 Linux open() 时，若 flags 中未包含 O_WRONLY 或 O_RDWR，系统将默认以只读（O_RDONLY = 0x0）方式打开文件，导致后续 WriteString 调用失败。

✅ 正确做法是：将 O_APPEND 与 O_WRONLY（或 O_RDWR）按位或组合使用：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

f, err := os.OpenFile("./log.log", os.O_APPEND|os.O_WRONLY, 0666)
if err != nil {
    panic(err)
}
defer f.Close() // 注意：建议用 defer 确保关闭

logTime := time.Now().Format(time.RFC3339)
if _, err := f.WriteString(logTime + " - " + msg + "\n"); err != nil {
    fmt.Printf("failed to write log: %v\n", err)
}

⚠️ 注意事项：

os.ModeAppend 是文件权限/模式标志（ FileMode ），用于 os.OpenFile 的第三个参数（perm），不能替代 O_APPEND；此处应传 0666（数字字面量）而非 os.ModeAppend（后者对应 0200，是 setuid 标志，完全无关）；
每次循环都重新打开/关闭文件效率低下，建议复用文件句柄（如在 goroutine 外打开一次，配合 sync.Mutex 或直接使用 log.Logger）；
生产环境推荐使用标准库 log 包或成熟日志库（如 zap、zerolog），它们内置线程安全与缓冲机制。

总结：O_APPEND 不等于“可写”，它只是写入策略；任何写操作都必须搭配 O_WRONLY 或 O_RDWR。牢记 Linux 系统调用规范——这是避免此类低级但棘手错误的关键。