Java ZipInputStream在子线程运行卡住、主线程正常运行问题求助

• 核心隐患：现有代码未确保文件输出路径的父目录已存在。Zip压缩包内的条目顺序不一定是目录在前、文件在后，当处理到所属目录尚未创建的文件条目时，Files.newOutputStream在Windows环境下可能因系统、安全软件拦截出现IO阻塞而非直接抛出异常，调试模式下安全软件通常会放行调试进程，因此不会触发该问题。
• 次要隐患：JDK内置ZipInputStream流式处理对带数据描述符、ZIP64格式的压缩包兼容性较差，子线程运行时可能因编码解析、内存映射逻辑触发死锁或阻塞。
• 额外触发因素：测试所用的模组压缩包存在多层级深目录，路径长度接近或超过Windows默认260字符限制，进一步放大了IO异常概率。

1. 强制创建父目录（必改） #

处理文件条目之前先创建其所有父级目录，修改对应逻辑如下：

} else {
    // 新增：确保文件的父目录一定存在
    Files.createDirectories(outPath.getParent());
    try (OutputStream outputStream = Files.newOutputStream(outPath)) {
        inputStream.transferTo(outputStream);
    }
}

2. 替换为ZipFile实现（更稳定） #

ZipFile采用随机访问模式处理压缩包，兼容性远高于流式的ZipInputStream，完整示例代码如下：

public static void main(String[] args) {
    new Thread(() -> {
        try {
            Path zipFile = Paths.get("C:\\path\\to\\zipfile.zip");
            Path outDir = Files.createDirectories(Paths.get("C:\\path\\to\\outDir"));
            
            try (ZipFile zip = new ZipFile(zipFile.toFile(), StandardCharsets.UTF_8)) {
                Enumeration<? extends ZipEntry> entries = zip.entries();
                while (entries.hasMoreElements()) {
                    ZipEntry entry = entries.nextElement();
                    Path outPath = outDir.resolve(entry.getName());
                    if (entry.isDirectory()) {
                        Files.createDirectories(outPath);
                    } else {
                        Files.createDirectories(outPath.getParent());
                        try (InputStream in = zip.getInputStream(entry);
                             OutputStream out = Files.newOutputStream(outPath)) {
                            in.transferTo(out);
                        }
                    }
                    System.out.println(entry.getName());
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }).start();
}

3. 新增JVM启动参数 #

如果仍有问题，在启动程序时添加以下参数规避Zip内存映射bug：
-Dsun.zip.disableMemoryMapping=true

4. 开启Windows长路径支持 #

Windows 10及以上版本可开启组策略中的「启用Win32长路径」选项，彻底解决路径长度限制问题。

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