java watchservice 是 nio.2 提供的轻量级文件系统事件监听机制，依赖操作系统原生通知，支持监控单目录下创建、删除、修改事件，但不递归子目录且 modify 事件不保证精确触发。
Java 的 WatchService 是 NIO.2 提供的轻量级文件系统事件监听机制，适合监控单个目录下文件的创建、删除、修改（注意：修改事件不保证每次写入都触发，且不递归子目录）。它底层依赖操作系统原生通知（如 Linux inotify、Windows ReadDirectoryChangesW），性能较好，但使用时需注意其限制和正确模式。
基础用法：注册目录并监听三种事件
WatchService 本身不主动轮询，而是阻塞等待事件。需在独立线程中调用 take() 或 poll() 获取事件。
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 先通过
FileSystems.getDefault().newWatchService()创建服务 - 用
Path.register(WatchService, WatchEvent.Kind...)注册目标目录，传入StandardWatchEventKinds.ENTRY_CREATE、ENTRY_DELETE、ENTRY_MODIFY - 每个事件包含类型、上下文（文件名）、修饰符（一般为 null）
- 必须手动调用
watchKey.reset()重置键，否则后续事件无法送达
关键细节：事件不是实时“精确”且不递归
WatchService 的行为受系统和 JVM 实现影响：
- ENTRY_MODIFY 可能被合并或丢失：频繁小写入（如日志追加）可能只触发一次 MODIFY，甚至不触发；它反映的是“文件属性变化”或“内容变更通知”，不等价于“文件被保存”
-
不监听子目录：注册
/a只监听/a/file.txt，不监听/a/b/c.txt；如需递归，需遍历所有子目录并分别注册（可用Files.walkFileTree配合SimpleFileVisitor） -
路径是相对的：事件中的
context()返回的是相对于注册目录的路径（如注册/log，新建/log/app.log，context 就是app.log） -
WatchKey 失效场景：目录被删除、权限变更、文件系统卸载会导致 key 无效，需检查
key.isValid()
实用示例：带重置与异常处理的监听循环
以下是一个健壮的监听片段（可直接运行）：
try (WatchService watcher = FileSystems.getDefault().newWatchService()) {
Path dir = Paths.get("/path/to/watch");
dir.register(watcher,
StandardWatchEventKinds.ENTRY_CREATE,
StandardWatchEventKinds.ENTRY_DELETE,
StandardWatchEventKinds.ENTRY_MODIFY);
System.out.println("开始监听 " + dir);
while (true) {
WatchKey key;
try {
key = watcher.take(); // 阻塞直到有事件
} catch (InterruptedException e) {
break;
}
for (WatchEvent> event : key.pollEvents()) {
WatchEvent.Kind> kind = event.kind();
Path filename = (Path) event.context();
Path fullPath = dir.resolve(filename);
System.out.printf("[%s] %s%n", kind.name(), fullPath);
}
if (!key.reset()) { // 重置失败说明目录已不可用
System.err.println("监听目录失效：" + dir);
break;
}
}
}
进阶建议：应对常见痛点
- 避免重复事件：某些编辑器（如 VS Code、IDEA）保存时会先写临时文件再原子替换，导致 CREATE + DELETE + CREATE 序列；可对文件名加简单去重或延时合并
- 跨平台兼容性：Windows 对 MODIFY 更敏感，macOS 使用 kqueue 效果略弱；生产环境建议配合定期扫描兜底（如每 5 秒 check lastModified）
-
资源管理：WatchService 是系统资源，务必用 try-with-resources 或显式 close；大量目录监听时注意系统 inotify 限额（Linux 可调
/proc/sys/fs/inotify/max_user_watches） -
替代方案参考：要求高精度或递归监听，可考虑 Apache Commons IO 的
FileMonitor（基于轮询）或第三方库如io.methvin.watchservice（增强版，支持递归与 macOS/Windows 兼容优化）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
