解压文件时mkdir()无法创建所需目录的问题排查与解决

你的问题根源很明确：mkdir()只能创建单级目录，如果解压的文件包含多级嵌套的目录结构（比如docs/report/2024/readme.txt），单靠mkdir()无法一次性创建所有父目录，这就会抛出"系统找不到指定路径"的错误。

下面是修复后的完整代码，同时我也优化了一些资源管理和路径处理的细节：

import java.io.*;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;

public static void unzip(File zipFile) throws IOException {
    byte[] buffer = new byte[1024];
    // 使用try-with-resources自动关闭流，避免资源泄漏
    try (ZipInputStream zis = new ZipInputStream(new FileInputStream(zipFile))) {
        ZipEntry zipEntry = zis.getNextEntry();
        // 定义解压根目录，用File构造器拼接更安全
        File extractRoot = new File(zipFile.getAbsolutePath().substring(0, zipFile.getAbsolutePath().lastIndexOf(".")));
        
        while (zipEntry != null) {
            File newFile = new File(extractRoot, zipEntry.getName());
            
            // 处理目录条目：如果当前ZipEntry是目录，直接创建多级目录
            if (zipEntry.isDirectory()) {
                // 用mkdirs()递归创建所有不存在的父目录
                if (!newFile.mkdirs()) {
                    throw new IOException("无法创建目录: " + newFile.getAbsolutePath());
                }
            } else {
                // 处理文件条目：先确保父目录存在
                File parentDir = newFile.getParentFile();
                if (parentDir != null && !parentDir.exists()) {
                    // 同样用mkdirs()创建多级父目录
                    if (!parentDir.mkdirs()) {
                        throw new IOException("无法创建父目录: " + parentDir.getAbsolutePath());
                    }
                }
                // 写入文件内容
                try (FileOutputStream fos = new FileOutputStream(newFile)) {
                    int len;
                    while ((len = zis.read(buffer)) > 0) {
                        fos.write(buffer, 0, len);
                    }
                }
            }
            
            zis.closeEntry();
            zipEntry = zis.getNextEntry();
        }
    }
}

关键修改点说明： #

• 替换mkdir()为mkdirs()：这是解决目录创建失败的核心，mkdirs()会递归创建所有不存在的父目录，而mkdir()只会在父目录已存在的情况下创建当前目录。
• 使用try-with-resources管理流：自动关闭ZipInputStream和FileOutputStream，避免手动关闭时可能出现的资源泄漏，代码也更简洁。
• 区分目录和文件条目：有些压缩包会包含单独的目录条目（比如docs/report/），需要单独处理创建目录的逻辑，避免把目录当成文件处理。
• 安全的路径拼接：用File的构造器new File(extractRoot, zipEntry.getName())来拼接路径，避免手动字符串拼接时的分隔符错误（比如Windows和Linux的路径分隔符差异）。
• 增加错误反馈：当目录创建失败时抛出明确的异常信息，方便排查问题。

另外，你原来的代码里在创建父目录时少了分号File f= new File(newFile.getParent())，这也是语法错误，修复后的代码已经修正了这个问题。

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