怎么通过 Files.getFileStore() 在 Java 层面监控服务器指定挂载点的磁盘水位预警

在 Java 服务端程序中，我们常常需要关注某些关键挂载点（例如日志盘、数据盘）的磁盘使用情况。JDK 自带的 java.nio.file.Files 类提供了 getFileStore 方法，可以让我们在纯 Java 层面获取文件存储的元数据，进而实现磁盘水位预警。

一、Files.getFileStore 基本用法

Files.getFileStore(Path) 会返回该路径所在的 FileStore 对象，通过它可以查询总空间、可用空间以及未分配空间。注意要捕获 IOException，因为某些路径可能无权访问。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.FileStore;

public class DiskProbe {
    public static void main(String[] args) throws Exception {
        // 指定要监控的挂载点路径
        Path path = Paths.get("/var/log");
        FileStore store = Files.getFileStore(path);
        long total = store.getTotalSpace();   // 总字节数
        long usable = store.getUsableSpace(); // 可用字节数
        System.out.println("总空间: " + total);
        System.out.println("可用空间: " + usable);
    }
}

二、计算水位并触发预警

所谓水位预警，通常是指可用空间占比低于某个阈值（如 15%）就报警。我们可以在定时任务中周期调用下面的方法。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.FileStore;

public class DiskWatcher {
    // 预警阈值：可用比例低于该值则预警
    private static final double THRESHOLD = 0.15;

    public static void checkMount(String mountPoint) {
        try {
            Path path = Paths.get(mountPoint);
            FileStore store = Files.getFileStore(path);
            long total = store.getTotalSpace();
            long usable = store.getUsableSpace();
            if (total <= 0) {
                return;
            }
            double usedRatio = 1.0 - (double) usable / total;
            if ((double) usable / total < THRESHOLD) {
                // 这里可以接入日志或告警系统
                System.out.println("预警: 挂载点 " + mountPoint
                        + " 可用空间仅剩 " + (usable * 100 / total) + "%");
            } else {
                System.out.println("正常: 已使用 " + (int)(usedRatio * 100) + "%");
            }
        } catch (Exception e) {
            System.err.println("读取 " + mountPoint + " 失败: " + e.getMessage());
        }
    }
}

三、集成到定时任务

可以用 ScheduledExecutorService 每隔一段时间检测一次，避免手动调用。

import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

public class ScheduleDemo {
    public static void main(String[] args) {
        var executor = Executors.newSingleThreadScheduledExecutor();
        // 每 5 分钟检查一次 /data 挂载点
        executor.scheduleAtFixedRate(() -> {
            DiskWatcher.checkMount("/data");
        }, 0, 5, TimeUnit.MINUTES);
    }
}

四、注意事项

• getFileStore 返回的是路径所在文件系统的存储，不是单个目录的大小。
• 在容器环境里，Java 读到的是宿主机挂载到容器内的视图，需确认挂载映射正确。
• 如果路径不存在或无权限，会抛出 IOException，需要做好异常处理。

使用 Files.getFileStore 做磁盘水位监控，无需执行 df 等系统命令，移植性好，适合嵌入到现有 Java 服务中做轻量级自检。

Files.getFileStore磁盘监控水位预警修改时间：2026-07-25 16:39:26