直接用z_stream解压内存数据可行但需手动管理缓冲区、调用循环和状态检查;必须清零结构体、正确设置windowBits、循环调用inflate()直至Z_STREAM_END、动态扩容输出缓冲区、最后调用inflateEnd()。

直接用 z_stream 解压内存中的压缩数据是可行的,但必须手动管理输入/输出缓冲区、调用顺序和状态检查——它不是“传入指针就返回解压结果”的封装函数,漏掉任意一步都会导致崩溃或静默失败。
初始化 z_stream 时必须显式清零并调用 inflateInit2()
z_stream 是 zlib 的核心结构体,未初始化的字段(尤其是 zalloc/zfree/opaque)若为随机值,inflateInit2() 可能直接 abort。不能只靠 memset(&strm, 0, sizeof(strm)) 就认为安全——还要确认 zlib 版本兼容性。
- 务必用
memset(&strm, 0, sizeof(z_stream))清零整个结构体 - 调用
inflateInit2(&strm, windowBits),其中windowBits需匹配压缩格式:15 表示标准 zlib,-15 表示 raw DEFLATE(无 header/tailer),8–15 均有效,但错配会导致Z_DATA_ERROR - 检查返回值是否为
Z_OK,否则后续所有调用都无效
inflate() 必须循环调用,且每次都要更新 next_in/avail_in 和 next_out/avail_out
内存解压不是单次操作。zlib 按内部块粒度处理数据,inflate() 返回 Z_OK 仅表示“还有更多输入可读”,不表示完成;返回 Z_STREAM_END 才是真正结束。常见错误是只调用一次就认为解压完了。
- 把压缩数据起始地址赋给
strm.next_in,长度赋给strm.avail_in - 分配足够大的输出缓冲区(如 4×输入大小),设
strm.next_out和strm.avail_out - 在
while (strm.avail_in > 0 || strm.avail_out == 0)循环中反复调用inflate() - 每次返回
Z_OK后,必须手动推进指针:strm.next_in += consumed; strm.avail_in -= consumed;(实际消耗量由strm.total_in - prev_total_in得到)
输出缓冲区不足时不能硬扩,而要重试或动态扩容
inflate() 遇到 strm.avail_out == 0 会返回 Z_OK 并暂停,此时必须提供新缓冲区空间再继续。强行增大 avail_out 而不更新 next_out 会导致越界写入。
立即学习“C++免费学习笔记(深入)”;
- 检测
inflate()返回Z_BUF_ERROR或avail_out == 0且avail_in > 0,说明输出空间耗尽 - 把已解压部分拷贝到更大缓冲区,更新
strm.next_out指向新空间末尾,strm.avail_out设为剩余容量 - 切勿复用原
next_out地址 + 增大avail_out,这等于告诉 zlib “后面内存可写”,极易触发段错误
清理必须调用 inflateEnd(),且不能重复调用
inflateEnd() 会释放 zlib 内部分配的内存(如滑动窗口)。忘记调用会导致内存泄漏;重复调用则可能 double-free。
- 只要
inflateInit2()成功返回Z_OK,无论后续inflate()是否成功,都必须调用inflateEnd() - 调用后立即把
strm.zalloc置为nullptr或加标记,避免二次调用 - 若在异常路径中提前退出(如抛异常),需确保
inflateEnd()在析构或catch块中执行
最易被忽略的是 windowBits 参数与压缩流格式的严格对应关系:gzip、zlib、raw DEFLATE 使用完全不同的头部解析逻辑,错配不会报错,而是返回 Z_DATA_ERROR 或解出乱码。调试时先用 zlib 自带的 zpipe 工具验证原始数据格式,再决定 inflateInit2() 的参数。



















