Go archive/zip Reader.RegisterDecompressor 怎样支持自定义压缩方法

archive/zip 只内置处理常见的 Store 和 Deflate 方法。遇到带有其他方法编号的 ZIP 条目时，可以先为当前 zip.Reader 调用 RegisterDecompressor，把方法 ID 映射到一个返回 io.ReadCloser 的函数。之后通过 File.Open 读取条目，标准库会按条目的 Method 选择这个解压器，并继续做 ZIP 层的大小与校验和处理。

官方文档：https://pkg.go.dev/archive/zip#Reader.RegisterDecompressor

Reader 级注册到底覆盖哪一层

我第一次遇到“ZIP 能列出文件名，却打不开内容”时，容易把问题归到路径或文件名上。真正应该先看的字段是 File.Method：它记录该条目采用的压缩方法编号。若这个编号不是标准库已有映射，File.Open 找不到解压器就会返回 zip.ErrAlgorithm。

Reader.RegisterDecompressor 是实例级覆盖。它把一个 uint16 方法编号和一个 zip.Decompressor 绑定到当前 Reader；如果当前 Reader 没有对应函数，标准库才继续查包级注册表。因此，多个 ZIP Reader 可以使用同一个方法编号，却各自持有不同的解压策略。

Decompressor 的签名决定了资源边界

解压器的输入是一个只读的 io.Reader，它代表当前 ZIP 条目的压缩数据；返回值是 io.ReadCloser，供后续读取解压后的内容。函数本身必须能被多个 goroutine 并发调用，但每个返回的读取器只会交给一个读取方使用。

package main

import (
    "io"
    "log"
    "archive/zip"
)

const customMethod uint16 = 99

func registerReaderDecoder(zr *zip.Reader) {
    zr.RegisterDecompressor(customMethod, func(src io.Reader) io.ReadCloser {
        // 示例只展示契约：真实项目应在这里接入对应方法的解压实现。
        return io.NopCloser(src)
    })
}

func openEntry(f *zip.File) ([]byte, error) {
    body, err := f.Open()
    if err != nil {
        return nil, err // 找不到方法或读取器创建失败时先返回错误。
    }
    defer func() {
        if closeErr := body.Close(); closeErr != nil {
            log.Printf("关闭 ZIP 条目失败: %v", closeErr)
        }
    }()
    // ReadAll 只适合小条目；大文件应改成分块读取并限制内存。
    return io.ReadAll(body)
}

上面的 io.NopCloser 只是把输入原样包装成可关闭读取器，不能把压缩字节自动变成明文。接入真实算法时，解压函数应返回对应实现的 io.ReadCloser，并确保 Close 能释放它持有的资源。

如果底层算法在创建阶段就可能失败，建议让自定义读取器在第一次 Read 时返回明确错误，或返回一个能表达失败状态的 ReadCloser；不要悄悄返回空内容，否则外层只能看到长度异常。

File.Open 之后仍然要处理读取和校验错误

RegisterDecompressor 只负责方法到解压器的映射，不负责验证压缩算法是否真的正确。File.Open 会先按条目方法选择解压器，然后把返回的读取器放进 ZIP 的校验包装中。读取完成时，解压器返回 io.EOF 并不等于整个操作必然成功：尺寸不一致可能变成 io.ErrUnexpectedEOF，CRC 不匹配则可能是 zip.ErrChecksum。

因此调用方要同时处理三个边界：打开阶段的 zip.ErrAlgorithm，读取阶段的格式、尺寸或校验和错误，以及最后的 Close 错误。不要因为“文件名已经列出来”就跳过内容读取错误，也不要把 OpenRaw 当成自定义解压入口；OpenRaw 明确返回的是未解压数据。

并发使用时记住这四个限制

• 把注册动作绑定到实际读取的 *zip.Reader，不要只在另一个 Reader 上注册。
• 解压器函数可以并发调用；它内部若复用可变缓冲，必须自行同步或为每次调用创建独立状态。
• 一个返回的 io.ReadCloser 只交给一个读取方，并在消费结束后关闭。
• 方法 ID 必须和归档中的真实 File.Method 一致；注册错误编号不会改变 ZIP 条目。

常见问题

为什么注册后仍然返回 zip.ErrAlgorithm？

先确认注册的是同一个 *zip.Reader，再打印条目的 File.Method。方法编号不一致、注册函数返回了空读取器，或实际条目走的是另一个 Reader，都会让结果与预期不同。

Decompressor 为什么不直接返回 error？

它的 API 约定是返回 io.ReadCloser。创建阶段无法用第二个返回值报告错误时，可以让返回的读取器在读取时暴露错误，并在上层统一处理。

用了自定义解压器还需要校验 CRC 吗？

需要。自定义解压器只解决如何产生明文，ZIP 层仍可能检查读取长度和 CRC；完整读取并正确关闭读取器，才能让这些错误有机会被观察到。