解压缩带字典的原始deflate数据时，inflateSetDictionary()何时调用有效？

核心结论 #

inflateSetDictionary()的有效调用时机，取决于你处理的是原始deflate数据还是带zlib头的压缩数据，手册里的“随时”是有前提的，并非所有场景都适用。

问题原因分析 #

1. 原始deflate数据的特殊逻辑
   你测试用的4字节原始deflate数据，是用字典"hello"压缩相同字符串生成的——这类压缩块完全依赖字典的内容做偏移引用，没有独立的原始数据块。当你先调用inflate()却未提前设置字典时，inflate在解析第一个压缩块时，就会发现需要引用一个不存在的历史窗口数据（字典内容），直接触发invalid distance too far back错误并返回Z_DATA_ERROR，根本不会走到返回Z_NEED_DICT的流程。

2. 手册描述的适用场景
   zlib手册里说“随时可调用”，是针对带zlib头的压缩数据而言的：这类数据的头部包含了字典的Adler-32校验和，inflate()会先解析头部，检测到需要字典后返回Z_NEED_DICT，这时再调用inflateSetDictionary()才会生效。

特殊情况的解释 #

• 默认zlib编码（WINDOW_BITS=15）正常工作：因为此时生成的压缩数据带zlib头，inflate能识别到字典需求，返回Z_NEED_DICT，后续设置字典的流程符合预期。
• 提前调用inflateSetDictionary()正常工作：在第一次inflate()前设置字典，inflate初始化时就把字典内容加载到历史窗口，解析依赖字典的压缩块时能直接找到对应数据，自然不会报错。

总结 #

这不是手册描述矛盾，而是你混淆了两种压缩格式的处理逻辑：

• 对于原始deflate数据：若压缩时从一开始就依赖字典，必须在第一次调用inflate()前设置字典；
• 对于带zlib头的压缩数据：可以在inflate()返回Z_NEED_DICT后再设置字典。

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