0

0

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

心靈之曲

心靈之曲

发布时间:2026-01-20 13:10:05

|

858人浏览过

|

来源于php中文网

原创

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

go 中 `os.write` 返回的错误通常是 `*os.patherror`,需通过类型断言提取其 `err` 字段,并与 `syscall.enospc` 比较,才能可靠识别磁盘满错误。

在 Go 语言中,底层系统调用失败时,标准库(如 os.File.Write)不会直接返回 syscall.Errno 类型错误,而是封装为更语义化的 *os.PathError。该结构体包含操作名、路径及底层系统错误 Err 字段——而这个 Err 才可能是 syscall.Errno。

因此,正确检测 ENOSPC 的方式是:先对 err 进行 *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 errno, ok := pathErr.Err.(syscall.Errno); ok && errno == syscall.ENOSPC {
                    log.Println("❌ Critical: No space left on device (ENOSPC)")
                    return
                }
            }

            // 可选:处理其他常见系统错误(如权限不足、设备忙等)
            log.Printf("Unexpected error type: %T, value: %v", err, err)
            return
        }
    }
}

关键点说明

Lumen5
Lumen5

一个在线视频创建平台,AI将博客文章转换成视频

下载
  • err.(*os.PathError) 是第一层断言,因为 os.Write 在文件操作失败时几乎总是返回此类型;
  • pathErr.Err 是嵌套的底层错误,需再次断言为 syscall.Errno 才能进行数值比较;
  • 直接 err.(syscall.Errno) 失败(如原问题中所示),是因为 err 并非裸 syscall.Errno,而是被 os.PathError 包装过;
  • 建议始终检查两次断言结果(ok),避免 panic;

⚠️ 注意事项

  • syscall.ENOSPC 是 Unix/Linux/macOS 常用常量;在 Windows 上对应错误码为 syscall.ERROR_HANDLE_DISK_FULL 或 syscall.ERROR_DISK_FULL,但 Go 标准库通常会统一映射为 ENOSPC(自 Go 1.13+ 起,os.IsNoSpace 已提供跨平台抽象);
  • 更推荐的现代写法(Go 1.13+):使用 errors.Is(err, syscall.ENOSPC) 或 os.IsNoSpace(err),它内部已自动处理包装层级:
if os.IsNoSpace(err) {
    log.Println("Out of disk space — handle gracefully")
}

该方法更简洁、可读性强,且具备跨平台兼容性,是当前最佳实践。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1468

2023.10.24

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

197

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

189

2025.07.04

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

601

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1104

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

792

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

452

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2349

2023.08.08

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

0

2026.01.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.5万人学习

Git 教程
Git 教程

共21课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号