Zip4j 1.3.2中setFileNameInZip字符限制及相关组件约束咨询

核心问题原因 #

在zip4j 1.3.2版本中，setFileNameInZip()传入的文件名如果包含斜杠/或直接等于/，会被判定为目录路径而非普通文件项。由于你开启了外部流模式写入内容，而目录项本身不需要写入数据，最终生成的压缩包仅包含空目录，表现为整体大小为0字节。

ZipOutputStream与ZipParameters的关键约束（1.3.2版本） #

• 路径分隔符解析规则：
  • 斜杠/和反斜杠\会被当作目录分隔符处理，用于生成嵌套目录结构。如果文件名以/开头、包含/或直接为/，zip4j会将其识别为目录，而非需要写入内容的文件。
  • 该版本不支持对路径分隔符进行转义，若要在文件名中保留类似符号，需替换为下划线、横杠等合法字符。
• 空/无效文件名限制：
  • 不能传入空字符串或仅含路径分隔符的字符串作为文件名，这类参数会被判定为无效文件项，不会写入任何数据。
• 加密与目录的兼容限制：
  • 使用ENC_METHOD_STANDARD（ZipCrypto）加密时，仅支持加密文件内容，不支持加密目录项。当你传入目录型文件名并开启加密时，会触发逻辑异常，导致无数据写入。
• 外部流模式的配套要求：
  • 开启setSourceExternalStream(true)后，必须保证fileNameInZip是合法的文件名（非目录路径），否则zip4j会跳过内容写入流程——因为目录不需要从外部流读取数据。

修复方案 #

方案1：处理文件名中的斜杠 #

对传入的文件名做预处理，替换掉斜杠：

String safeFileName = fileName.replaceAll("/", "_");
zipParameters.setFileNameInZip(safeFileName);

方案2：创建嵌套目录（若需保留目录结构） #

如果确实需要生成包含目录的压缩包，需先添加目录项，再写入对应文件：

// 先创建目录项
ZipParameters dirParams = new ZipParameters();
dirParams.setFileNameInZip("target_dir/");
dirParams.setDirectory(true);
zout.putNextEntry(null, dirParams);
zout.closeEntry();

// 再写入目录下的文件
ZipParameters fileParams = new ZipParameters();
fileParams.setCompressionMethod(Zip4jConstants.COMP_DEFLATE);
fileParams.setCompressionLevel(Zip4jConstants.DEFLATE_LEVEL_FASTEST);
fileParams.setEncryptFiles(true);
fileParams.setEncryptionMethod(Zip4jConstants.ENC_METHOD_STANDARD);
fileParams.setPassword(password);
fileParams.setSourceExternalStream(true);
fileParams.setFileNameInZip("target_dir/" + originalFileName); // originalFileName不含路径分隔符

zout.putNextEntry(null, fileParams);
try {
    byte[] buffer = new byte[4096];
    int num;
    while ((num = bis.read(buffer)) != -1) {
        zout.write(buffer, 0, num);
    }
    zout.flush();
    zout.closeEntry();
    zout.finish();
} finally {
    // 关闭流操作
}

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