Go zip.NewReader 读取非 seekable 数据时如何改用 ReaderAt

如果 ZIP 数据来自 HTTP 响应体，最容易踩的坑是把 io.Reader 直接传给 zip.NewReader。这个函数不接受普通流，而是要求一个能按偏移读取的 io.ReaderAt，并且还要传入完整 ZIP 字节数。实用改法是：小归档先用 io.ReadAll 收集字节，再用 bytes.NewReader 构造随机读取视图；归档较大时落到临时文件，用 *os.File 提供 ReaderAt。

先记住三点：① Reader 只能顺序读，ReaderAt 能按偏移读；② size 必须是完整归档长度，不是当前已读长度；③ 成员文件的 Open 返回值要关闭。

先分清 NewReader 需要什么

zip.NewReader(r, size) 会从 ZIP 尾部寻找中央目录，再根据目录中的偏移读取成员，所以接口设计成 io.ReaderAt。HTTP body、管道和大多数消息流只有 Read，无法在读取后跳回某个偏移；即使底层内容确实是 ZIP，也不能直接转换成 ReaderAt。

转换的关键不是给流“加一个 Seek”，而是先确定完整字节边界。内存方案中，len(data) 同时就是 ReaderAt 的有效长度；如果 size 写小，尾部目录可能被截断，如果写大，解析又可能读到不存在的区域。

用 bytes.Reader 接住非随机读取流

下面的函数接收一个普通 io.Reader，一次性读完后再交给 zip.NewReader。代码中的注释说明了转换和资源关闭的目的；这是操作示意代码，不代表已经在本机执行过。

package main

import (
	"archive/zip"
	"bytes"
	"fmt"
	"io"
)

func listZipFiles(src io.Reader) error {
	// 先把只能顺序读取的输入固定成完整字节集合，才能支持后续随机访问。
	data, err := io.ReadAll(src)
	if err != nil {
		return fmt.Errorf("读取 ZIP 流失败: %w", err)
	}

	// bytes.Reader 同时提供 ReadAt 和 Len；Len() 是完整归档的 size。
	reader := bytes.NewReader(data)
	zr, err := zip.NewReader(reader, int64(reader.Len()))
	if err != nil {
		return fmt.Errorf("解析 ZIP 失败: %w", err)
	}

	for _, file := range zr.File {
		// Open 返回的读取器需要关闭，避免成员读取资源悬挂。
		rc, err := file.Open()
		if err != nil {
			return fmt.Errorf("打开成员 %q 失败: %w", file.Name, err)
		}
		_, copyErr := io.Copy(io.Discard, rc)
		closeErr := rc.Close()
		if copyErr != nil {
			return fmt.Errorf("读取成员 %q 失败: %w", file.Name, copyErr)
		}
		if closeErr != nil {
			return fmt.Errorf("关闭成员 %q 失败: %w", file.Name, closeErr)
		}
		fmt.Println(file.Name)
	}
	return nil
}

这里不要把 reader.Len() 当作“剩余未读长度”：新建 bytes.Reader 后它尚未消费，才等于整个 ZIP 大小。如果在别处先读过这个 reader，应保存原始总长度，或重新创建一个新的 bytes.Reader。

大文件改用临时文件的 ReaderAt

io.ReadAll 会把整个归档放进内存，适合大小可控的上传包、模板包和测试数据。对大文件，更稳妥的生命周期是“流式写临时文件—关闭写入句柄—重新打开—解析—删除”。os.File 实现了 io.ReaderAt，文件大小则来自 Stat().Size()。

解析阶段只把索引和当前成员需要的数据读入内存，处理完后关闭 zip.ReadCloser（如果使用 zip.OpenReader）或文件句柄，并删除临时文件。临时文件方案仍然要求保存完整数据；它只是把随机读取的载体从内存换成磁盘，不会让一个未完成的网络流变成可随机读取对象。

三个边界问题要提前处理

第一，网络响应的 Content-Length 不能替代实际读取结果：它可能缺失、被压缩传输影响，或与正文不一致，最终应以完整字节或临时文件的实际大小为准。第二，zip.NewReader 返回错误时不要继续遍历 File；格式损坏、目录截断和不支持的压缩算法都应回到调用方。第三，读取成员时不要只检查 Open，复制内容和 Close 同样要处理错误。

如果输入本来就是本地文件，直接使用 zip.OpenReader 更简单；只有当数据已经进入普通 io.Reader，或需要自定义存储载体时，才需要显式完成 ReaderAt + size 这一层转换。

常见问题

能不能用 io.ReadSeeker 代替 ReaderAt？不能直接代替。zip.NewReader 的签名明确要求 io.ReaderAt；如果只有可 Seek 的对象，应改用文件实现、读取到内存，或实现符合语义的 ReadAt。

为什么解析时 size 不能随便写成很大的数？因为它描述的是 r 中有效 ZIP 数据的边界。应传入实际完整长度，而不是为了“保险”扩大范围；边界不准确会让中央目录定位和后续读取失去可靠依据。

参考：Go archive/zip 官方文档、Go io 官方文档。本文代码与插图均为原创示意。