Java Deflater 的 nowrap 参数生成什么压缩数据

如果对接方只说“使用 deflate 压缩”，真正需要确认的不是压缩级别，而是它要不要 zlib 包装。Java 的 Deflater 默认生成 zlib 格式；只有构造函数的 nowrap 设为 true 时，才会去掉 zlib 的头部和校验字段，输出原始 DEFLATE 数据。

记住这一对即可：new Deflater(level, false) 对应带 zlib 包装的数据，new Deflater(level, true) 对应 raw deflate。解压端也要分别使用 new Inflater() 和 new Inflater(true)。

官方资料：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/util/zip/Deflater.html

nowrap=false 和 nowrap=true 到底差在哪里

Deflater 使用的是同一套 DEFLATE 压缩算法，nowrap 改变的是外层数据格式，而不是把算法换成另一种压缩方式。默认构造方式会保留 zlib 的头部和 Adler-32 校验字段；传入 true 后，这两个字段不再由 Deflater 输出，留下的是可以嵌入其他格式的原始 DEFLATE 流。

因此，nowrap=true 不能简单理解为“压缩得更小”。去掉的是格式包装，长度差异取决于输入内容和压缩流本身。更重要的是，对端必须知道自己接收的是 raw deflate，否则即使压缩过程没有报错，解压也可能从第一个字节开始失败。

用一个方法固定 Deflater 的输出模式

实际项目里不要让调用方到处传布尔值。可以把格式选择集中在压缩方法入口，同时保证输入结束后调用 finish()，再持续取出直到 finished()。deflate() 返回的是本轮写入的字节数，不能把整个临时缓冲区都当成有效结果。

import java.io.ByteArrayOutputStream;
import java.nio.charset.StandardCharsets;
import java.util.zip.Deflater;

public final class DeflateCodec {
    private DeflateCodec() {
        // 工具类不需要被实例化。
    }

    public static byte[] compress(String text, boolean rawDeflate) {
        byte[] input = text.getBytes(StandardCharsets.UTF_8);
        ByteArrayOutputStream output = new ByteArrayOutputStream();

        // rawDeflate=true 会去掉 zlib 头和 Adler-32 校验字段。
        try (Deflater deflater = new Deflater(Deflater.DEFAULT_COMPRESSION, rawDeflate)) {
            deflater.setInput(input);
            // 告知压缩器输入已经结束，否则 finished() 可能一直不会成立。
            deflater.finish();

            byte[] buffer = new byte[512];
            while (!deflater.finished()) {
                int count = deflater.deflate(buffer);
                // 只追加本轮实际生成的字节，避免把缓冲区尾部空位写入结果。
                output.write(buffer, 0, count);
            }
        }
        return output.toByteArray();
    }
}

调用方应该把 rawDeflate 绑定到协议字段，而不是根据返回数组的长度猜测格式。例如，协议明确要求 zlib 时传入 false；协议明确要求 raw deflate 时传入 true。如果协议文档没有说明这一点，应先让双方补充约定，不能靠尝试某个解压器碰运气。

解压端必须和 nowrap 对齐

压缩端与解压端的匹配关系是对称的。nowrap=false 产生的 zlib 数据交给普通 Inflater；nowrap=true 产生的原始 DEFLATE 数据交给 new Inflater(true)。下面的方法保留了流式解压最关键的几个判断，并在解压完成后关闭本地资源。

import java.io.ByteArrayOutputStream;
import java.util.zip.DataFormatException;
import java.util.zip.Inflater;

public final class InflateCodec {
    private InflateCodec() {
        // 工具类不需要被实例化。
    }

    public static byte[] decompress(byte[] compressed, boolean rawDeflate)
            throws DataFormatException {
        ByteArrayOutputStream output = new ByteArrayOutputStream();

        // 解压端的 nowrap 必须与压缩端使用同一约定。
        try (Inflater inflater = new Inflater(rawDeflate)) {
            inflater.setInput(compressed);
            byte[] buffer = new byte[512];
            while (!inflater.finished()) {
                int count = inflater.inflate(buffer);
                if (count == 0 && inflater.needsDictionary()) {
                    // 需要预置字典时，调用方必须按协议提供同一份字典。
                    throw new DataFormatException("压缩流需要预置字典");
                }
                if (count == 0 && inflater.needsInput()) {
                    // 输入已耗尽仍未结束，通常意味着数据不完整或格式不匹配。
                    throw new DataFormatException("压缩流未结束");
                }
                output.write(buffer, 0, count);
            }
        }
        return output.toByteArray();
    }
}

这里的 rawDeflate 必须来自协议配置或消息元数据。不要把“先用普通 Inflater，失败后再改成 true”当成正式协议设计：这样会隐藏发送端配置错误，也可能让同一个接口在不同数据上表现不一致。

raw deflate 不是 GZIP，也不是 ZIP

JDK 文档说明，nowrap=true 去掉 zlib 头和校验字段，是为了支持 GZIP 和 PKZIP 所使用的压缩格式。这里说的是它们内部采用的 DEFLATE 数据部分，不代表 new Deflater(..., true) 会自动生成一个完整的 GZIP 文件或 ZIP 文件。

• raw deflate：只有 DEFLATE 数据流，没有 zlib、GZIP 或 ZIP 的容器头尾。
• zlib：在 DEFLATE 外增加 zlib 包装和校验信息，通常用 Inflater() 对应解压。
• GZIP：有自己的文件头和尾部校验，完整 GZIP 成员应使用 GZIP 相关入口处理。
• ZIP：是带目录和条目结构的容器，不能把一个 raw deflate 数组直接当成 ZIP 文件。

如果对方的协议字段写的是“deflate”，还要进一步确认它指的是 zlib 格式还是 raw deflate。名称相同不等于字节布局相同，最好在协议文档中直接写出 zlib-wrapped deflate 或 raw deflate，并同时写明解压端。

遇到解压失败时先看哪一层

排查时先确认双方的构造参数，再看数据是否完整，最后才考虑压缩级别或字符编码。下面几种症状通常指向包装层不一致：

压缩级别 0 到 9 主要影响压缩策略，不决定是否存在 zlib 包装；nowrap 才是这个问题的关键开关。另一个容易漏掉的点是资源释放：Deflater 和 Inflater 都应通过 close() 或 end() 释放本地资源。

最后用一张表固定协议约定

可以把格式选择收敛成下面这条规则：协议是 zlib，就让压缩端使用 nowrap=false、解压端使用 Inflater()；协议是 raw deflate，就让两端都使用 true；协议是 GZIP 或 ZIP，则使用对应的完整容器工具，不要把它们简化成 nowrap 的别名。

文章中的关键结论只有一个：nowrap 控制的是 zlib 包装是否存在，不能用来判断 GZIP 或 ZIP 容器。只要把压缩数据边界和解压入口同时写进协议，Java 的 Deflater 就不会因为一个布尔参数造成跨端解压失败。

相关问题

nowrap=true 生成的是 GZIP 文件吗？

不是。它生成的是不带 zlib 头尾的 raw deflate 数据，GZIP 的文件头和尾部仍然需要由 GZIP 格式工具负责。

Java 的 Inflater 为什么也有 nowrap 参数？

因为解压端同样要知道输入是否省略了 zlib 包装。压缩端用 true 时，解压端通常也要用 new Inflater(true)。

只把 Deflater 的压缩级别改成 BEST_COMPRESSION 能解决头部错误吗？

不能。压缩级别改变压缩策略，不改变 zlib 与 raw deflate 的数据边界；头部错误应先检查 nowrap 和解压入口是否匹配。