Java 1.8中File.mkdirs()返回true但未创建文件夹问题求助

这个问题我在高并发批量创建目录的场景下也遇到过，Java 1.8的File.mkdirs()确实存在并发语义上的缺陷，导致偶尔出现返回成功但目录实际没创建的情况。

问题根源 #

File.mkdirs()的底层实现并没有完全保证原子性：当多个线程同时尝试创建同一层级的目录时，某个线程可能会因为检测到“目录似乎已存在”而返回true，但实际上另一个线程的创建操作可能还未完成，或者因为文件系统的延迟/竞争，最终目录并没有被成功创建。而且File类的方法在并发场景下的错误反馈不够明确，不会抛出异常，只会返回布尔值，这就导致问题很难排查。

解决方案 #

1. 改用Java NIO2的Files.createDirectories()（推荐）

Java 7引入的NIO2 API（java.nio.file包）针对并发场景做了优化，Files.createDirectories()是线程安全的，并且会在创建失败时抛出明确的IOException，不会出现“假成功”的情况。示例代码如下：

import java.nio.file.Files;
import java.nio.file.Paths;
import java.io.IOException;

// 在并行任务中替换原有的File.mkdirs()调用
try {
    Files.createDirectories(Paths.get("你的目录路径"));
    // 可选：创建后再做一层验证，避免极端情况下的文件系统延迟
    if (!Files.isDirectory(Paths.get("你的目录路径"))) {
        throw new IOException("目录创建后验证失败");
    }
} catch (IOException e) {
    // 可以捕获具体异常类型，比如FileAlreadyExistsException、AccessDeniedException等
    e.printStackTrace();
    // 加入重试逻辑或错误降级处理
}

这个方法不仅能避免并发下的假成功问题，还能通过异常信息更精准地定位问题（比如权限不足、路径已存在文件等）。

2. 对File.mkdirs()加同步控制（仅兼容旧代码时用）

如果因为某些原因必须使用File类的方法，可以通过同步锁来避免并发竞争。比如针对每个目录路径加锁（或按路径哈希分锁，比全局锁性能更好）：

// 按路径哈希分锁，减少锁竞争
private static final int LOCK_COUNT = 16;
private static final Object[] LOCKS = new Object[LOCK_COUNT];

static {
    for (int i = 0; i < LOCK_COUNT; i++) {
        LOCKS[i] = new Object();
    }
}

public static boolean safeMkdirs(String path) {
    int lockIndex = path.hashCode() % LOCKS.length;
    synchronized (LOCKS[lockIndex]) {
        File dir = new File(path);
        if (dir.exists()) {
            return dir.isDirectory();
        }
        boolean created = dir.mkdirs();
        // 创建后立即验证
        return created && dir.exists() && dir.isDirectory();
    }
}

注意：全局锁会让并行创建变成串行，严重影响性能，所以分锁是更优的选择，但整体还是不如NIO2方案优雅。

3. 增加创建后的验证与重试逻辑

不管用哪种创建方式，都可以在创建后额外验证目录是否真的存在，并加入重试机制：

public static boolean createDirectoryWithRetry(String path, int retryTimes) throws InterruptedException {
    for (int i = 0; i < retryTimes; i++) {
        File dir = new File(path);
        if (dir.exists() && dir.isDirectory()) {
            return true;
        }
        if (dir.mkdirs()) {
            // 短暂休眠，避免文件系统延迟导致的验证失败
            Thread.sleep(10);
            if (dir.exists() && dir.isDirectory()) {
                return true;
            }
        }
        // 重试间隔
        Thread.sleep(50);
    }
    return false;
}

这种方式可以弥补File.mkdirs()的缺陷，但可靠性不如NIO2方案。

总结 #

最稳妥的方案是切换到NIO2的Files.createDirectories()，它从API设计层面就解决了并发场景下的原子性问题，并且提供了更清晰的错误反馈。如果必须兼容旧代码，再考虑加同步或验证重试的方式。

内容的提问来源于stack exchange，提问作者Sathish Kumar