Apache Commons IO 的 FileAlterationMonitor 默认不区分“修改”与“重写”，但通过合理使用 FileAlterationListener 的 onFileChange() 回调，可精准捕获文件被覆盖（如 OutputStream.write() 覆盖原内容）引发的内容变更事件。
apache commons io 的 `filealterationmonitor` 默认不区分“修改”与“重写”，但通过合理使用 `filealterationlistener` 的 `onfilechange()` 回调，可精准捕获文件被覆盖（如 `outputstream.write()` 覆盖原内容）引发的内容变更事件。
在基于文件系统的监控场景中，开发者常误以为“文件覆盖”（例如用 Files.write() 或 FileOutputStream 重新写入同名文件）必须拆解为“删除 + 创建”两步才能被监听器识别。实际上，只要文件未被删除（即磁盘上 inode/文件句柄仍存在），且其内容或元数据发生变更，FileAlterationMonitor 就会触发 onFileChange() 回调——这正是检测覆盖行为的核心机制。
onFileChange() 并非仅响应“编辑保存”类操作，而是由底层 File.lastModified() 和 File.length() 的变化所驱动。当一个文件被覆盖写入（例如 Files.write(path, data, StandardOpenOption.WRITE)），其最后修改时间必然更新、长度也可能变化，从而被 FileAlterationObserver 捕获并分发至监听器。
以下是一个完整可用的监听器实现示例：
import org.apache.commons.io.monitor.FileAlterationListenerAdaptor;
import org.apache.commons.io.monitor.FileAlterationObserver;
import java.io.File;
public class OverwriteAwareListener extends FileAlterationListenerAdaptor {
@Override
public void onFileChange(File file) {
System.out.printf("[DETECT] File overwritten or modified: %s (size=%d, modified=%tc)%n",
file.getAbsolutePath(),
file.length(),
file.lastModified());
// ✅ 此处即为“覆盖发生”的可靠信号点
// 可触发校验、备份、事件通知等业务逻辑
}
// 注意：onFileCreate() 和 onFileDelete() 无需在此处理覆盖场景
// 因为覆盖不涉及文件创建/删除（除非显式 delete+create）
}
配合 FileAlterationMonitor 使用：
File directory = new File("/path/to/watch");
FileAlterationObserver observer = new FileAlterationObserver(directory);
observer.addListener(new OverwriteAwareListener());
FileAlterationMonitor monitor = new FileAlterationMonitor(5000); // 5秒轮询间隔
monitor.addObserver(observer);
monitor.start();
⚠️ 关键注意事项：
- 轮询间隔影响实时性：FileAlterationMonitor 是轮询机制，最小延迟受 interval 参数限制（不支持 inotify/kqueue 原生事件）；生产环境建议设为 1–5 秒平衡性能与响应速度。
- 覆盖 ≠ 删除重建：若业务代码先 file.delete() 再 Files.write()，则会依次触发 onFileDelete() → onFileCreate()，而非 onFileChange()；此时需统一收口文件写入逻辑，优先使用覆盖式 API（如 StandardOpenOption.WRITE）避免误判。
- 权限与符号链接：确保监控目录可读，且 FileAlterationObserver 默认不递归跟踪符号链接目标——如有需要，需自定义 FileFilter 或升级至 Commons IO 2.11+ 配合 FileVisitOption.FOLLOW_LINKS。
✅ 总结：无需复杂状态机或时间戳比对，onFileChange() 即是 Apache Commons IO 中检测文件覆盖最直接、轻量且可靠的钩子。将其作为事件入口，即可稳健支撑日志截断、配置热更新、上传文件替换等典型覆盖型业务场景。
