gzip解压失败时常见错误是服务端返回content-encoding: gzip但客户端未解压，导致响应体乱码或json解析失败；关键在于inflateinit2需传-15识别gzip头部，且必须完整拼接数据后一次性解压。
gzip解压失败时常见错误信息是什么
遇到 HTTP 200 但响应体乱码、或解析 JSON 报 invalid UTF-8，大概率是服务端返回了 Content-Encoding: gzip 却没解压。curl 或浏览器自动处理了，但 C++ 原生 std::http（还没进标准）或 socket 自实现 HTTP 客户端不会自动解压。错误本身不报错，只是数据不对——这是最隐蔽的坑。
用 zlib 解压 gzip 格式数据的关键参数
zlib 的 inflateInit2 必须传 -MAX_WBITS 才能识别 gzip 头部（而非 raw deflate）。传 15 是默认 deflate，会失败；传 -15 才正确。别信某些老教程说“用 inflateInit 就行”，它只支持 zlib header。
-
int ret = inflateInit2(&strm, -15);—— 负数才是 gzip 模式 - 输入 buffer 必须包含完整 gzip 流（含 magic header
1f 8b），不能截断 -
strm.avail_in设为实际字节数，strm.next_in指向原始数据起始 - 输出 buffer 大小要预估：gzip 压缩率通常 3–10 倍，建议初始分配 4× 输入大小
如何安全处理流式 gzip 数据（比如 chunked transfer）
网页响应可能分块传输（Transfer-Encoding: chunked），但 gzip 是整体压缩，不能逐 chunk 解压。必须先拼接所有 body 字节，再一次性解压。若强行流式解压，inflate 会卡在 Z_BUF_ERROR 或返回 Z_DATA_ERROR。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 收到
Content-Encoding: gzip时，禁用 chunked 解析逻辑，直接 accumulate 到std::vector<uint8_t></uint8_t> - 检查首两字节是否为
0x1f 0x8b，不是就不是 gzip，别硬解 - 解压后用
strm.total_out获取真实解压长度，不要依赖输出 buffer 大小 - 若服务端发的是
deflate（非标准，有些 Nginx 配置），需尝试inflateInit+15，但概率低，优先按 gzip 处理
一个最小可行解压函数示例
以下函数假设你已拿到完整的 gzip bytes（std::vector<uint8_t> const& gz_data</uint8_t>），不处理网络 I/O：
std::vector<uint8_t> ungzip(const std::vector<uint8_t>& gz_data) {
z_stream strm;
strm.zalloc = Z_NULL; strm.zfree = Z_NULL; strm.opaque = Z_NULL;
int ret = inflateInit2(&strm, -15);
if (ret != Z_OK) return {};
<pre class="brush:php;toolbar:false;">strm.avail_in = gz_data.size();
strm.next_in = const_cast<unsigned char*>(gz_data.data());
std::vector<uint8_t> out(4 * gz_data.size());
strm.avail_out = out.size();
strm.next_out = out.data();
ret = inflate(&strm, Z_FINISH);
if (ret != Z_STREAM_END) {
inflateEnd(&strm);
return {};
}
out.resize(strm.total_out);
inflateEnd(&strm);
return out;</uint8_t>
}
注意 inflate 返回 Z_STREAM_END 才算成功；Z_OK 可能只是部分输出，Z_BUF_ERROR 通常是输出 buffer 不够——这点容易被忽略，导致截断。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
