Java文件操作需写入前主动校验磁盘空间，通过Files.getFileStore()获取FileStore并调用getUsableSpace()判断是否足够，预留缓冲、封装安全写入方法、处理动态路径回溯父目录、配合日志与监控提升可靠性。
Java 文件操作无法自动感知磁盘空间不足并中断写入，必须在写入前主动检查可用空间，否则可能因 IOException（如 “No space left on device”）导致程序异常终止或数据损坏。关键在于：**写入前校验 + 明确提示 + 可控失败**。
1. 写入前检查目标路径所在分区的可用空间
不能只看文件大小，要确认目标目录所在文件系统的剩余字节数是否足够。使用 FileStore 获取准确信息：
- 用
Paths.get(dirPath).toFile().getAbsoluteFile().getFileSystem().getPathMatcher("glob:**")不够；应通过Files.getFileStore(path)获取对应FileStore -
fileStore.getUsableSpace()返回当前用户可写入的字节数（考虑权限和 reserved 空间），比getTotalSpace()或getUnallocatedSpace()更可靠 - 建议预留缓冲（例如 10MB），避免因日志、临时文件等并发写入导致临界失败
2. 封装可校验的写入工具方法
把检查逻辑与写入动作绑定，避免遗漏。例如：
- 定义方法
safeWrite(Path target, byte[] content, long minRequiredBytes) - 先调用
Files.getFileStore(target)，捕获IOException（如路径不存在、无权限） - 比较
fileStore.getUsableSpace() >= minRequiredBytes + 10_000_000L - 不满足则抛出自定义异常
InsufficientDiskSpaceException("磁盘空间不足：需 X MB，仅剩 Y MB")，含具体数值便于排查
3. 处理多级目录或动态路径的注意事项
若目标路径尚不存在（如 /data/log/2024/06/01/app.log），getFileStore() 会失败。此时需向上回溯到最近存在的父目录：
立即学习“Java免费学习笔记（深入）”；
- 循环调用
path.getParent()，直到Files.exists(parent)为 true - 再对首个存在的 parent 调用
Files.getFileStore() - 注意：不要用根路径（如
/）兜底，某些容器环境挂载点可能不一致
4. 配合日志与监控提升可观测性
单纯抛异常不够，生产环境需留痕：
- 记录警告日志：包含路径、所需空间、可用空间、触发时间、JVM PID
- 对高频写入场景（如日志轮转），可添加指标埋点（如
disk_space_check_failure_total） - 避免每写一次都查空间——对固定目录可缓存
FileStore引用（它本身是线程安全的），定期刷新（如每分钟）
