directorynotemptyexception 是 java nio.2 中 files.delete() 删除非空目录时抛出的受检异常，属 filesystemexception 子类，非 ioexception，需显式捕获；其设计体现原子性删除原则，不递归，遇子项即抛异常。
DirectoryNotEmptyException 是 Java NIO.2 中 Files.delete() 方法抛出的受检异常（checked exception），当尝试删除一个**非空目录**时触发。它属于 java.nio.file.FileSystemException 的子类，但不是 IOException，因此不能被通用的 IOException 捕获覆盖——这点容易忽略。
为什么 delete() 会抛出 DirectoryNotEmptyException
Java 的 Files.delete(Path) 设计为“原子性删除”：只删空目录或单个文件，不递归。这是为了安全和语义明确。若目录下有子文件、子目录（哪怕不可读或隐藏），就会直接抛出该异常，而不是静默失败或部分删除。
常见误判场景：
- 用
Files.isDirectory()判断是目录后直接调用delete()，未检查是否为空 - 跨平台路径处理（如 Windows 下的
$RECYCLE.BIN或 macOS 的.DS_Store）导致实际非空但肉眼难察觉 - 多线程/进程并发操作，目录在 check 和 delete 之间被写入新内容（TOCTOU 问题）
推荐做法：用 deleteIfExists + walkFileTree 递归删除
标准且健壮的方式是先递归删除所有内容，再删目录本身。Java 提供了 Files.walkFileTree() 配合 SimpleFileVisitor，可精准控制错误处理和权限逻辑：
示例代码：
try {
Files.walkFileTree(path, new SimpleFileVisitor<path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
Files.delete(file);
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
if (exc == null) {
Files.delete(dir); // 空目录才删
} else {
throw exc; // 上层文件删除失败，中断
}
return FileVisitResult.CONTINUE;
}
});
} catch (IOException e) {
// 统一处理所有 I/O 异常（含 DirectoryNotEmptyException）
throw new RuntimeException("Failed to delete directory: " + path, e);
}
</path>
替代方案：使用 Files.deleteIfExists() + 手动判断
如果只需简单清理、且能接受“删不掉就跳过”，可用更轻量方式：
- 先用
Files.deleteIfExists(path)尝试删除（它不抛DirectoryNotEmptyException，失败返回false） - 若返回
false且Files.isDirectory(path)为true，说明是非空目录，再走递归逻辑 - 注意：
deleteIfExists对不存在路径也返回true，需结合exists()判断真实状态
避免踩坑的关键细节
-
DirectoryNotEmptyException是运行时异常（RuntimeException的间接子类？错！它是FileSystemException，属于受检异常，必须显式处理） - 不要用
catch (Exception e)模糊捕获——会掩盖权限不足、只读文件等真正需要区分的错误 - 对符号链接要小心：
walkFileTree默认不跟随，若需处理链接目标，需传入FileVisitOption.FOLLOW_LINKS - 大目录删除建议加超时或进度回调，避免长时间阻塞；生产环境建议用异步+重试机制
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
