NotDirectoryException 是 Java NIO 在路径存在但类型为文件而非目录时自动抛出的异常，常见于 Files.list() 等要求目录的操作；需通过 Files.exists() 和 Files.isDirectory() 双重校验预防。
Java NotDirectoryException 是什么情况触发的
这个异常不是你手动 throw 的，而是 Java NIO 文件 API 在「本该操作目录」却遇到普通文件时，自动抛出的运行时异常。典型场景：调用 Files.list()、Files.walk()、Files.createDirectory() 或 Files.isDirectory() 配合断言逻辑时，路径指向了一个真实存在的文件而非目录。
Files.list(path) 报 NotDirectoryException 怎么快速定位
根本原因只有一个：传给 list() 的 path 指向的是一个文件（比如 "config.json"），而它只接受目录路径。它不会帮你判断或跳过——直接炸。
- 先用
Files.exists(path)确认路径存在，再用Files.isDirectory(path)显式检查，二者都为true才安全调用list() - 别依赖路径字符串含
"/"或名字带"dir"就认为是目录；文件系统才是唯一权威 - Windows 下注意路径分隔符误写成
"\"导致解析失败，可能意外落到父级某个同名文件上
和 IOException / NoSuchFileException 的关键区别
NotDirectoryException 是 FileSystemException 的子类，属于更细粒度的语义错误。它明确告诉你：“路径存在，类型也确定了，但它不是目录”——这比 NoSuchFileException（路径根本不存在）或泛泛的 IOException 更有诊断价值。
-
NoSuchFileException：路径压根没找到，可能是拼错、权限不足、软链接断裂 -
NotDirectoryException：路径找到了，但isRegularFile() == true，而你调用了只对目录合法的操作 - 捕获时别一股脑 catch
IOException就完事，否则会掩盖这个明确的类型不匹配问题
避免踩坑的三个实操习惯
这类异常本质是“预期与现实类型不符”，修复不在 try-catch，而在前置校验和路径来源管控。
立即学习“Java免费学习笔记（深入）”；
- 所有外部输入的路径（如配置项、命令行参数、HTTP 请求路径），在交给
Files.list()或Files.walk()前，必须做Files.isDirectory(path)+Files.exists(path)双检 - 不要复用同一个
Path变量既当文件又当目录用；变量命名带上语义，比如configFile和pluginDir，IDE 和团队都能一眼识别意图 - 单元测试里故意用一个已存在的文件路径去调用
list()，确认你的防护逻辑真能提前拦截，而不是等跑线上才暴露
最麻烦的不是异常本身，而是它往往出现在路径由用户/配置动态生成的环节——那里最容易绕过本地开发时的“我知道这是个目录”的直觉假设。
