Java NIO WatchService是依赖系统原生通知的轻量级目录监控机制，仅监听单层目录、ENTRY_MODIFY语义不精确、需手动重置WatchKey；核心步骤为创建服务、注册目录、take阻塞获取key、pollEvents解析事件。
Java NIO 的 WatchService 是监控目录级文件变更（创建、删除、修改）的轻量级机制，它不轮询，而是依赖操作系统原生通知（如 Linux 的 inotify、Windows 的 ReadDirectoryChangesW），响应快、资源占用低。但它只监听**单层目录**，不自动递归子目录；ENTRY_MODIFY 事件语义不精确，可能合并、延迟甚至丢失；且必须手动重置监听键才能持续接收新事件。
注册监听并启动事件循环
核心四步不可省略：
- 调用
FileSystems.getDefault().newWatchService()创建服务实例（线程安全，可复用） - 用
Paths.get("/path/to/watch")获取目标目录的Path - 对该
Path调用.register(watchService, ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY)—— 注意：只注册目录本身，不包含其子目录 - 在独立线程中循环调用
watchService.take()阻塞等待事件，获取WatchKey后遍历其pollEvents()
正确解析事件信息
每个 WatchEvent 包含三要素，需结合使用：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
event.kind()：返回StandardWatchEventKinds.ENTRY_CREATE等类型，注意OVERFLOW表示事件队列溢出，应视为潜在丢失，建议触发一次全量目录扫描兜底 -
event.context()：是相对于注册路径的Path（例如注册/log，新建/log/app.log，则 context 是app.log），必须用注册根路径.resolve(context)拼出绝对路径 -
event.count()：同一事件短时间内多次触发时的累计次数（如快速保存可能连续触发多个 MODIFY），可用于做简单去抖判断
处理关键限制与健壮性问题
生产环境必须应对以下常见陷阱：
立即学习“Java免费学习笔记（深入）”；
-
非递归监听：注册
/a不会收到/a/b/c.txt的事件。需用Files.walkFileTree()遍历所有子目录，并为每个子目录单独register()；监听到ENTRY_CREATE且是目录时，立即对其递归注册 -
MODIFY 不可靠：编辑器保存常先写临时文件再重命名，可能触发
CREATE + DELETE而非MODIFY；频繁小写入（如日志追加）可能只上报一次 MODIFY。建议对同一文件路径加时间窗口去抖（如 100ms 内重复 MODIFY 忽略） -
WatchKey 失效：目录被删、权限变更或卸载会导致
key.isValid()返回false。每次处理完事件后必须调用key.reset()，并检查返回值，false时应退出该 key 的循环 -
跨文件系统失效：移动文件到另一挂载点会触发
ENTRY_DELETE，而非MODIFY。若需追踪跨分区行为，需配合文件指纹（如 xxHash）比对
基础代码结构示意（不含异常处理）
以下是最简可用骨架，突出主干逻辑：
WatchService watcher = FileSystems.getDefault().newWatchService();
Path dir = Paths.get("/target");
dir.register(watcher, ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY);
while (true) {
WatchKey key = watcher.take(); // 阻塞等待
for (WatchEvent<?> event : key.pollEvents()) {
WatchEvent.Kind<?> kind = event.kind();
Path name = (Path) event.context();
Path fullPath = dir.resolve(name); // 拼出绝对路径
if (kind == ENTRY_CREATE && Files.isDirectory(fullPath)) {
// 是新建目录 → 立即注册它
fullPath.register(watcher, ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY);
}
// ... 其他业务处理
}
if (!key.reset()) break; // key 失效则退出
} 
