Go gzip.Reader读取完整后仍需Close的原因与实践

我在处理 gzip 日志时遇到过一个容易误判的现象：数据已经读完，代码里却仍然保留着 gzip.Reader 的 Close。原因是“读完”和“关闭”解决的不是同一件事。读取走到 io.EOF，才有机会让 gzip 校验长度和校验和；Reader.Close 负责结束解压读取器本身，但不会替你关闭底层的文件或 HTTP 响应体。

为什么读完还要 Close：两个边界不是一回事

gzip.NewReader 接受的是 io.Reader，返回的解压器只负责从它读取并产出未压缩数据。官方文档明确说明，调用者负责在使用完成后关闭这个 Reader，而且 Reader 的 Close 不会关闭底层 reader。

另一个关键点是校验时机。gzip 数据带有未压缩长度和校验和，Reader 只有在读取到数据末尾时才能确认它们。正常的 io.Copy 或 io.ReadAll 会继续读到 io.EOF；如果压缩流损坏，读取阶段可能返回 gzip.ErrChecksum。所以“拿到了部分明文”不等于“文件已经可信”。

把读取错误和 Close 放在同一个资源范围里

实践里我更愿意让 gzip.Reader 在创建成功后立刻登记关闭动作，再把真正的内容读取错误返回给调用方。下面的函数把文件关闭、gzip 读取和校验错误分开处理，适合一次性读取小型压缩文件：

func readGzipFile(path string) ([]byte, error) {
	// 文件句柄由当前函数打开，因此也由当前函数负责关闭。
	f, err := os.Open(path)
	if err != nil {
		return nil, fmt.Errorf("打开 gzip 文件失败: %w", err)
	}
	defer f.Close()

	zr, err := gzip.NewReader(f)
	if err != nil {
		return nil, fmt.Errorf("读取 gzip 头失败: %w", err)
	}
	// Reader.Close 不会关闭 f，但要结束解压器的使用状态。
	defer zr.Close()

	data, err := io.ReadAll(zr)
	if err != nil {
		// ErrChecksum、截断和底层 I/O 错误都必须让调用方知道。
		return nil, fmt.Errorf("读取 gzip 内容失败: %w", err)
	}
	return data, nil
}

这里的重点不是把 Close 写成装饰，而是不要把它误当作校验动作。校验结果来自完整读取过程；资源释放则由两个不同的 defer 分别兜底。若文件很大，换成 io.Copy 写入目标文件即可，判断逻辑不变。

文件和 HTTP Body 要单独关闭

当输入来自 HTTP 响应时，所有权关系会更明显：gzip.Reader 是包装层，resp.Body 才是网络响应体。关闭前者不会释放后者，因此两者都应在各自创建成功后登记：

func copyGzipResponse(dst io.Writer, resp *http.Response) error {
	// 响应体来自 HTTP 客户端，函数消费完后负责关闭它。
	defer resp.Body.Close()

	zr, err := gzip.NewReader(resp.Body)
	if err != nil {
		return fmt.Errorf("响应不是有效 gzip: %w", err)
	}
	defer zr.Close()

	// Copy 读到 EOF 才能让 gzip Reader 检查尾部长度和校验和。
	if _, err := io.Copy(dst, zr); err != nil {
		return fmt.Errorf("解压响应失败: %w", err)
	}
	return nil
}

如果只想读取拼接流中的一个 gzip 成员，可以在读取前调用 zr.Multistream(false)；需要复用同一个 Reader 时，再结合 Reset。这两个选择改变的是流边界，不改变“完整读取检查数据、各层资源各自关闭”的原则。

一张表记住判断顺序

我的经验是把“内容是否完整”和“资源是否释放”写成两条独立检查线：前者看读取错误，后者看每层对象的所有权。这样即使以后把文件换成网络流，代码也不容易出现只关了包装器、却漏掉底层连接的情况。

相关问题

只调用 gzip.Reader.Close 能验证校验和吗？

不能。要让 gzip 校验真正发生，必须持续读取到数据末尾；Close 本身不会替代完整读取。

gzip.Reader.Close 会关闭 os.File 吗？

不会。它不关闭传入的底层 reader，文件、响应体或其他拥有 Close 方法的对象要单独处理。

读取到部分数据后遇到 ErrChecksum 能继续使用吗？

不应把这部分数据当成完整结果。应记录错误、丢弃或隔离这次结果，并按业务需要重新获取可靠的压缩源。