如何在 Java 中通过 NotDirectoryException 校验传入的文件路径变量是否符合目录操作预期
在 Java NIO 编程实践中，NotDirectoryException 是一个常见的运行时异常。它通常在你尝试对一个非目录路径执行目录专属操作时抛出，例如调用 Files.list()、Files.walk() 或 Files.createDirectory()。然而，一个关键认知需要明确：它本身并非用于主动校验的工具，而更像一个“事后报告者”——操作失败后，它才告知原因。因此，最佳实践并非依赖捕获它来进行校验，而是应该主动预判，提前验证路径是否为有效目录，从而在源头规避异常的发生。
使用 Files.isDirectory() 主动验证目录状态
最直接且推荐的做法是什么？就是在执行目录操作前，先确认路径的“身份属性”。
- 调用
Files.isDirectory(path)方法。若返回true，则表明该路径不仅存在、可访问，而且确实是一个目录（而非普通文件或指向文件的符号链接）。 - 其优势在于，方法内部已妥善处理了路径不存在、权限不足、非目录等多种边界情况，直接以
false返回值表明不符合预期，整个过程静默高效，不会引发异常。 - 以下是一个典型的使用示例：
Path dir = Paths.get("/tmp/data");
if (Files.isDirectory(dir)) {
try {
Files.list(dir).forEach(System.out::println);
} catch (IOException e) { /* 处理真正的 I/O 错误 */ }
} else {
throw new IllegalArgumentException("路径不是有效目录: " + dir);
}
结合 Files.exists() 与 Files.isReadable() 进行更严谨的预检
当然，有时仅确认目录属性可能不够。若对代码健壮性要求更高，例如需确保后续遍历操作绝对可靠，组合条件判断往往是更稳妥的选择。
- 首先使用
Files.exists(path)确保路径确实存在（默认不追踪符号链接）。 - 接着使用
Files.isDirectory(path)确认其目录属性。 - 最后，别忘了添加
Files.isReadable(path)检查，以确保当前进程拥有读取权限，这对于list()、walk()等操作是必需的。 - 只有当这三项检查全部通过，返回
true，方可放心进行后续的目录遍历与操作。
避免依赖 NotDirectoryException 进行流程控制
你或许会考虑，是否可以用 try-catch 包裹操作，通过捕获 NotDirectoryException 来实现校验？理论上可行，但这在实践中被视为一种反模式，原因如下：
立即学习“Java免费学习笔记（深入）”；
- 首先，异常机制本身存在性能开销，将其用于常规逻辑分支处理，在效率上并不经济。
- 其次，这会模糊代码的真实意图。你真正需要表达的逻辑是“验证该路径是否可作为目录使用”，而非“先尝试操作，失败后再处理异常”。
- 再者，这种做法可能混淆其他 I/O 异常，例如 SecurityException 或 AccessDeniedException，使得错误诊断与处理变得复杂且不精确。
- 最后，从代码可读性与设计规范角度看，它违背了“快速失败”与“明确断言”的原则，导致代码逻辑不够清晰直观。
注意符号链接的默认处理行为
另一个值得关注的细节是：Files.isDirectory(path) 方法默认不跟随符号链接。这意味着，若 path 是一个指向文件的软链接，该方法返回 false；若指向目录，则返回 true。如果你的应用场景需要对符号链接采取特定处理策略，可以通过传入 LinkOption.NOFOLLOW_LINKS（此为默认行为）或 LinkOption.FOLLOW_LINKS 来显式指定。
