C++使用libzip zip_fread读图片遇空字节截断致损坏如何解决

zip_fread 接口本身不会将内容中的0x00空字节判定为EOF，其返回值为实际读取的字节数，与读取内容的字节取值无关。你遇到的二进制文件解压损坏问题来自两处代码缺陷：

• 未做循环读取处理：zip_fread 不保证单次调用就能读满传入的目标长度，当压缩条目分块存储、文件体积较大时，单次调用可能仅返回部分数据，直接跳过剩余字节读取会导致内容缺失。
• 输出文件未以二进制模式打开：Windows平台下std::ofstream默认采用文本模式打开文件，写入时会对特殊控制字符做转义处理，甚至将部分字节识别为文件终止标记截断写入，这是图片等二进制文件损坏、纯文本文件正常的核心原因。

另外原代码存在内存泄漏问题：new 申请的内容缓冲区未主动释放。

按以下三点修改代码即可正常解压包含空字节的二进制文件：

1. 循环调用zip_fread，累计读取字节数直到达到压缩条目实际大小，同时增加读取错误判断
2. 构造输出文件流时传入std::ios::binary标记，禁用文本模式的特殊字符处理逻辑
3. 读取、写入流程结束后主动释放申请的堆缓冲区，避免内存泄漏

将原代码中读取、写入对应的逻辑替换为以下内容即可：

struct zip_stat ist;
zip_stat_init(&ist);
zip_stat(za, name, 0, &ist);
// 优先处理大小为0的空文件
if (ist.size == 0) {
    std::ofstream outFile(fullFilePath, std::ios::binary);
    outFile.close();
    continue;
}
char* contents = new char[ist.size];
zip_file* f = zip_fopen(za, name, 0);
if (f == nullptr) {
    delete[] contents;
    zip_close(za);
    return EXIT_FAILURE;
}

zip_int64_t bytes_read = 0;
zip_int64_t total_read = 0;
// 循环读取直到读满文件总长度
while (total_read < static_cast<zip_int64_t>(ist.size)) {
    bytes_read = zip_fread(f, contents + total_read, ist.size - total_read);
    if (bytes_read < 0) { // 读取发生错误
        delete[] contents;
        zip_fclose(f);
        zip_close(za);
        return EXIT_FAILURE;
    }
    if (bytes_read == 0) break; // 到达真实文件末尾
    total_read += bytes_read;
}

if (CreateDirectory(fullDir.c_str(), NULL) || ERROR_ALREADY_EXISTS == GetLastError())
{
    // 以二进制模式打开输出文件
    std::ofstream outFile(fullFilePath, std::ios::binary);
    if (!outFile.write(contents, total_read))
    {
        delete[] contents;
        zip_fclose(f);
        zip_close(za);
        return EXIT_FAILURE;
    }
    outFile.close();
}
// 释放缓冲区、关闭压缩内文件句柄
delete[] contents;
zip_fclose(f);

• 所有压缩库的块读取接口（包括zip_fread、标准库fread等）都不保证单次调用读满请求长度，必须通过循环累计读取的方式处理，不能假设一次调用就能拿到全部内容。
• 所有跨平台的二进制文件读写操作，都必须显式指定二进制打开模式，避免Windows平台文本模式的特殊逻辑导致文件内容被篡改。

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