Java文件操作磁盘空间不足时抛IOException，需结合FileSystemException消息、FileStore.getUsableSpace()预检及异常后清理降级来可靠识别与处理。
磁盘空间不足时，Java 文件操作（如 FileOutputStream.write()、Files.write()、FileChannel.write() 等）通常会抛出 IOException，但该异常本身不直接说明是“空间不足”。需要结合异常类型、错误码（在支持的系统上）和系统级检查来可靠识别并安全处理。
识别真正的磁盘空间不足异常
IOException 是个宽泛异常，不能仅靠捕获它就认定是磁盘满。关键判断依据如下：
- 检查异常是否为
java.io.IOException的子类java.nio.file.FileSystemException（常见于 NIO 操作），其getMessage()或getReason()可能包含"No space left on device"、"Disk quota exceeded"等明确提示； - 在 Linux/Unix 系统上，可通过
getCause()获取底层UnixException，再调用errno()判断是否等于Errno.ENOSPC（需使用jdk.internal.misc.Unsafe或反射，生产环境不推荐）； - 更稳妥方式：捕获
IOException后，主动调用File.getUsableSpace()或FileStore.getUsableSpace()检查目标路径所在分区剩余空间是否接近零（例如小于 1MB），确认是否真因空间不足失败。
写入前主动预检磁盘空间
预防优于补救。在执行大文件写入或批量写入前，先评估可用空间：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 获取目标文件父目录所在
FileStore：Path path = Paths.get("/data/output.txt"); FileStore store = Files.getFileStore(path.getParent()); - 估算待写入字节数（如文件大小、缓冲区长度、压缩后预估等），与
store.getUsableSpace()对比； - 预留安全余量（例如至少保留 50MB），避免因临时文件、日志、系统缓存导致临界失败；
- 若空间不足，提前抛出自定义业务异常（如
InsufficientDiskSpaceException）或降级处理（如切换到备用存储、压缩数据、通知管理员）。
异常发生后的安全恢复与降级策略
即使预检通过，写入过程中仍可能因并发占用、配额动态变化等原因失败。此时应：
立即学习“Java免费学习笔记（深入）”；
- 确保资源正确释放：使用 try-with-resources 包裹流（
OutputStream、Channel），避免句柄泄漏； - 清理已创建但未写完的临时文件（如
tempFile.delete()或Files.deleteIfExists(tempPath)）； - 记录带上下文的错误日志（含路径、预计大小、可用空间、异常堆栈），便于运维定位；
- 提供用户友好的反馈（如 “磁盘空间不足，请清理后重试”），而非暴露原始异常信息；
- 考虑自动降级：转用内存缓存、分块压缩写入、或上传至对象存储（如 S3/OSS）作为备选路径。
避免常见误区
以下做法容易导致问题被掩盖或处理失效：
- 只捕获
Exception或空 catch 块，忽略具体原因； - 依赖
IOException.toString()做字符串匹配（不同 JVM/系统语言环境返回内容不一致）； - 用
File.length()或getFreeSpace()替代getUsableSpace()—— 前者对普通用户不可用，后者不考虑配额和保留空间； - 在 finally 中强制删除目标文件（可能误删有效文件），应只清理明确标记为“临时”或“未完成”的文件。
