Java监听文件系统实时变动核心靠WatchService，它基于操作系统底层事件通知（如inotify），通过注册目录、接收事件、重置监听键实现高效监控，需注意资源释放、事件类型筛选、递归注册子目录及业务解耦设计。
Java 中监听文件系统实时变动，核心靠的是 WatchService——它是 JDK 7 引入的 NIO.2 文件监控机制，不轮询、不比对，直接利用操作系统底层事件通知（如 Linux inotify、Windows ReadDirectoryChangesW），效率高、资源省。
WatchService 的基本工作流程
它不是“主动扫描”，而是“被动收信”：注册目录 → 操作系统在文件变动时发信号 → Java 线程取事件 → 处理后重置监听键。整个过程依赖三个关键角色：
-
WatchService：监听服务本体，通过
FileSystems.getDefault().newWatchService()获取，需手动 close -
WatchKey：注册返回的句柄，代表“某目录已加入监听队列”，每次事件触发后必须调用
key.reset()才能继续接收新事件 -
WatchEvent：具体变动信息，含类型（
ENTRY_CREATE/ENTRY_MODIFY/ENTRY_DELETE）、相对路径（event.context()）和完整路径（需用watchDir.resolve(filename)拼接）
监听单个目录的标准写法
适用于配置目录、插件目录等固定路径场景。注意异常处理与资源释放：
- 用 try-with-resources 或 finally 块确保
watchService.close()被执行，避免句柄泄漏 - 注册时只传需要的事件类型，避免无用事件干扰（
OVERFLOW通常不注册） - 主循环建议用
watchService.take()阻塞等待，比轮询poll()更省 CPU - 每个事件处理完后必须调用
key.reset()，否则该目录后续事件将不再进入队列
递归监听子目录的注意事项
WatchService 默认只监听注册目录的一级变动，若要监控整个目录树（如日志目录含多层子文件夹），需手动遍历并逐级注册：
立即学习“Java免费学习笔记（深入）”；
- 先注册根目录，再用 BFS 或 DFS 遍历所有子目录，对每个
Path调用register() - 子目录新增时，需额外监听
ENTRY_CREATE事件，捕获新建目录后立即为其注册监听 - 注意 Windows 下深度嵌套或符号链接可能导致注册失败，建议加 try-catch 并记录警告
与业务逻辑解耦的关键设计
监听本身是通用能力，业务处理（如热加载配置、触发备份）应隔离：
- 定义回调接口（如
FileChangeHandler），只暴露onFileChanged(Path, Kind)方法 - 监听线程只负责取事件、拼路径、分发，不做具体业务；避免阻塞导致事件积压
- 对高频修改（如编辑器频繁保存）可做简单去重或合并（例如 100ms 内多次 MODIFY 视为一次）
- 生产环境建议增加事件队列缓冲（如
BlockingQueue），防止业务处理慢拖垮监听线程
