Java Files.createDirectories 已存在目录时怎样安全处理

在 Java 中初始化缓存、导出或上传目录时，推荐把 Files.createDirectories(path) 当成可重复执行的准备动作：它会补齐不存在的父目录，目标目录已经存在时不会因为“已存在”本身抛错；但如果同一路径落到普通文件上，仍应把它当成真实配置冲突处理。

官方文档：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/nio/file/Files.html

先记住一句话：createDirectory 适合只创建一级目录，createDirectories 适合准备一棵可能尚不存在的目录树。后者不是“忽略所有异常”，而是只对目标目录已经存在这一情况更友好。

先区分 createDirectory 和 createDirectories

Files.createDirectory 只创建指定的一级目录，父目录不存在时会失败；Files.createDirectories 会先创建缺失的父目录，并且目标目录已经存在时不因这一点抛异常。两者遇到同名普通文件时都不能把它当成目录继续使用。

因此，启动阶段、批处理任务和测试夹具通常更适合使用 createDirectories。只有在你明确要求“父目录必须已经存在，并且只能创建这一层”时，才选择 createDirectory。

用 createDirectories 安全准备多级目录

下面的写法可以重复执行。第一次运行会创建缺少的父目录，第二次运行仍返回目标路径；真正需要处理的是权限、非法路径、文件系统故障或路径被普通文件占用。

import java.io.IOException;
import java.nio.file.FileAlreadyExistsException;
import java.nio.file.Files;
import java.nio.file.Path;

public class WorkspaceDirectory {
    public static Path prepare(Path root) throws IOException {
        // 让调用方只传根目录，具体子目录由初始化逻辑统一决定。
        Path exportDir = root.resolve("var").resolve("exports");
        try {
            // 可重复执行：缺少的父目录会一起创建，已有目录不会单独报错。
            return Files.createDirectories(exportDir);
        } catch (FileAlreadyExistsException e) {
            // 同名路径存在但不是目录时，保留原始路径便于记录和排查。
            throw new IOException("导出目录被普通文件占用: " + exportDir, e);
        }
    }
}

这里显式捕获 FileAlreadyExistsException 是为了把“路径冲突”翻译成更接近业务的错误消息。官方 API 也说明，若目标路径定位到一个不是目录的已有文件，createDirectories 可以抛出这个更具体的异常。

目标目录已存在时，哪些情况仍然要报错

“目录已存在”与“路径存在”不是一回事。可以把结果分成三类：目标是目录，操作成功；目标不存在，创建成功；目标是普通文件或其他不匹配的文件系统对象，初始化失败。

不要先用 Files.exists 判断，再决定是否创建。检查和创建之间可能被其他进程改变，先检查还会让代码多出一个竞态窗口。直接调用创建方法，再按异常类型处理，通常更直接。

public static void ensureDirectory(Path dir) throws IOException {
    try {
        // 直接执行创建动作，避免 exists 判断与创建之间产生竞态。
        Files.createDirectories(dir);
    } catch (FileAlreadyExistsException e) {
        // 已有路径不是目录，继续写入会把真正错误推迟到更后面。
        throw new IOException("路径不是目录: " + dir, e);
    }
}

把目录准备放进启动和任务流程

目录初始化最好靠近真正使用它的边界：应用启动时准备固定工作区，任务执行前准备按任务划分的子目录。不要在每次写文件前散落一份创建逻辑，否则异常上下文和权限问题会很难追踪。

如果路径来自配置或用户输入，调用前要明确根目录和允许的相对路径范围；createDirectories 只负责文件系统创建，不负责替你做业务授权。对于共享目录，还要结合操作系统权限、符号链接策略和并发写入约束。

记录异常时至少包含目标路径、操作阶段和原始原因。例如“准备导出目录失败”比“写文件失败”更容易判断是配置、权限还是磁盘问题。若目录创建失败后继续运行，后续写入通常只会给出更晚、更模糊的异常。

常见问题

目录已经存在，为什么 createDirectory 仍然失败？

这是它的语义：createDirectory 创建一个新目录，目标已存在时并不把它当作成功。需要可重复执行的目录准备时，优先使用 createDirectories。

createDirectories 会忽略所有 FileAlreadyExistsException 吗？

不会。目标已经是目录时不会因为存在本身抛错；如果同名路径是普通文件，仍然是冲突，应保留异常并停止当前初始化。

总结

Files.createDirectories 适合准备可能缺失的多级目录，并天然支持重复执行。正确做法是直接调用它，把“已有目录”与“普通文件占用路径”区分开，再在启动或任务边界集中记录错误。这样既避免了多余的存在性检查，也不会把路径配置错误伪装成目录已就绪。

参考来源

https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/nio/file/Files.html