使用ZipOutputStream时文件名编码异常问题求助

我来帮你搞定这个Java Zip打包时的编码坑！当你的文件名包含é这类非ASCII字符时，直接用默认配置的ZipOutputStream会导致解压后文件名乱码，根源在于Java默认用CP437编码处理Zip文件名，而CP437无法正确支持拉丁扩展字符。

问题分析 #

老式Zip格式标准使用CP437编码存储文件名，这是为了兼容DOS系统，但完全不支持Unicode字符。当你传入带é的文件名时，默认的ZipOutputStream会把这些字符转成CP437无法表示的占位符，解压后就会变成乱码。

解决方案（Java 7+ 推荐） #

我们需要强制ZipOutputStream使用UTF-8编码存储文件名，同时让Zip格式标记这是Unicode文件名。以下是修正后的完整代码片段：

import java.io.BufferedOutputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.util.Map;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;

// 你的业务代码逻辑
ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
BufferedOutputStream bufferedOutputStream = new BufferedOutputStream(byteArrayOutputStream);

// 关键：指定UTF-8编码创建ZipOutputStream，Java 7+支持
try (ZipOutputStream zout = new ZipOutputStream(bufferedOutputStream, StandardCharsets.UTF_8)) {
    for (Map.Entry<String, byte[]> entry : yourPdfMap.entrySet()) {
        String frenchFileName = entry.getKey();
        byte[] pdfContent = entry.getValue();
        
        // 创建ZipEntry，直接传入带法语字符的文件名
        ZipEntry zipEntry = new ZipEntry(frenchFileName);
        
        zout.putNextEntry(zipEntry);
        zout.write(pdfContent);
        zout.closeEntry();
    }
} catch (IOException e) {
    // 替换成你的异常处理逻辑
    e.printStackTrace();
}

// 后续可以将byteArrayOutputStream转成字节数组用于下载或存储
byte[] zipBytes = byteArrayOutputStream.toByteArray();

额外说明 #

1. try-with-resources语法：自动关闭ZipOutputStream，避免资源泄漏，这是Java 7+的推荐写法。
2. Java 6兼容方案：如果你的项目还在使用Java 6，无法直接指定编码构造ZipOutputStream，可以手动设置文件名编码并标记通用标志位：

   ZipOutputStream zout = new ZipOutputStream(bufferedOutputStream);
   // 手动设置编码
   zout.setEncoding("UTF-8");
   // 手动标记文件名使用UTF-8（部分旧工具需要这个标志）
   zipEntry.setGeneralPurposeBit(zipEntry.getGeneralPurposeBit() | 0x800);
   

3. 解压兼容性：大多数现代解压工具（WinRAR、7-Zip、Java的ZipInputStream）都支持UTF-8编码的Zip文件名，但如果要兼容非常老旧的工具，可能需要权衡是否使用ASCII文件名。

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