使用minizip(zlib 1.2.3)压缩4GB以上文件失败的求助

问题现象 #

使用minizip（基于zlib 1.2.3）压缩XML文件时，当原文件大小超过4GB（即32位int最大值4294967295字节），解压生成的压缩包会出现未预期错误0x80004005，但7zip可正常解压。观察到压缩后文件记录的大小为原文件总字节数减去4294967295，存在明显的数值溢出问题。

所用代码片段 #

int returnVal = zipOpenNewFileInZip4(reinterpret_cast<zipFile>(m_pzipFile),
                                    fileName, NULL, NULL, 0, NULL, 0, NULL,
                                    Z_DEFLATED, Z_DEFAULT_COMPRESSION, 0,
                                    -MAX_WBITS, DEF_MEM_LEVEL, Z_DEFAULT_STRATEGY,
                                    NULL, 0, m_uGeneralflag);
// 常量说明：Z_DEFLATED=0, Z_DEFAULT_COMPRESSION=-1, MAX_WBITS=15, DEF_MEM_LEVEL=8, Z_DEFAULT_STRATEGY=0

zipWriteInFileInZip(reinterpret_cast<zipFile>(m_pzipFile), pBuffer, actualBufferSize);
// 参数说明：pBuffer为char*类型的待写入缓冲区；actualBufferSize为int类型的缓冲区大小

zipCloseFileInZip(reinterpret_cast<zipFile>(m_pzipFile));

问题根源分析 #

核心问题是32位int类型的溢出：

• zlib 1.2.3配套的minizip版本默认使用32位整数记录文件大小，当文件超过4GB时，数值溢出导致存储的大小被错误计算为原大小 - 2^32。
• 解压时读取该错误大小值，触发0x80004005未指定错误；而7zip会自动识别并处理Zip64格式的扩展字段，因此能正常解压。

排查与修复方案 #

• 升级minizip/zlib版本：zlib 1.2.3是2005年的老旧版本，后续版本的minizip已原生支持Zip64格式，可正确处理超过4GB的文件。建议升级至zlib 1.2.11及以上版本，配套使用支持Zip64的minizip实现。
• 手动启用Zip64扩展：若无法直接升级，需修改代码启用Zip64标志：
  1. 调用zipOpenNewFileInZip4时，确保m_uGeneralflag包含Zip64相关标志（具体值需参考对应版本的minizip头文件，通常为0x0001类定义）。
  2. 修改zipWriteInFileInZip的参数类型：actualBufferSize使用int类型会导致单次写入超过2GB时溢出，需改为unsigned int或size_t，同时确保底层函数支持64位写入长度。
• 校验Zip文件结构：压缩完成后，检查Zip文件的中央目录记录，确认原文件大小是否以64位字段存储（Zip64格式会额外添加扩展字段记录64位大小）。
• 替换压缩库：若升级成本过高，可替换为原生支持大文件的压缩库，比如libzip或7-zip SDK。

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