Go 中如何正确判断 write 操作因磁盘空间不足(ENOSPC)而失败

在 go 中,`os.write` 返回的错误通常是 `*os.patherror` 类型,其 `err` 字段封装了底层系统调用的 errno(如 `syscall.enospc`),需通过类型断言提取并比对,而非直接断言为 `syscall.errno`。

Go 的 I/O 错误设计遵循分层封装原则:当 os.File.Write 失败时,标准库返回的是 *os.PathError(实现了 error 接口),它不仅包含操作名(如 "write")和路径(如 "dump.txt"),还通过 Err 字段保存原始系统错误(例如 syscall.ENOSPC)。因此,不能直接对 err 做 err.(syscall.Errno) 断言——因为 PathError.Err 才是真正的 errno 类型值。

正确的做法是先断言为 *os.PathError,再检查其 Err 字段是否等于 syscall.ENOSPC。以下是修正后的完整示例:

package main

import (
    "log"
    "os"
    "syscall"
)

func main() {
    fd, err := os.Create("dump.txt")
    if err !=

nil { log.Fatal("failed to create file:", err) } defer fd.Close() for { buf := make([]byte, 1024) _, err := fd.Write(buf) if err != nil { log.Printf("Write error: %v", err) // 正确方式:断言为 *os.PathError,再检查其 Err 字段 if pathErr, ok := err.(*os.PathError); ok { if pathErr.Err == syscall.ENOSPC { log.Println("❌ Out of disk space! (ENOSPC)") break } log.Printf("⚠️ Other system error: %v", pathErr.Err) } else { log.Printf("⚠️ Unexpected error type: %T", err) } break } } }
✅ 关键点总结:os.PathError 是 Go 文件操作的标准错误包装器;pathErr.Err 是 syscall.Errno 类型(即底层 errno 值),可直接与 syscall.ENOSPC 等常量比较;直接对 err 断言 syscall.Errno 必然失败,因其实际类型是 *os.PathError;生产环境建议同时处理其他常见错误(如 syscall.EIO、syscall.EBADF),并添加重试或清理逻辑。

此外,注意避免忽略 os.Create 的初始错误(原代码中使用 _ 忽略),否则文件创建失败时程序会 panic。健壮的实现应始终校验打开/创建文件的返回值。