Go archive/zip Writer.Close 失败时为什么不能忽略错误

用 Go 的 archive/zip 打包目录时，文件内容写完并不等于 ZIP 已经完整。Writer.Close() 还要把中央目录写入底层 io.Writer；如果这一步失败，压缩包可能缺少索引，读取方就无法可靠打开。正确做法是把 Write、Writer.Close 和底层文件的 Close 分开处理，并在确认全部成功后再替换正式文件。

Writer.Close 为什么仍然可能失败

ZIP 文件由局部文件数据和末尾的中央目录组成。zip.NewWriter 创建的 Writer 会把局部数据交给底层写入器，但中央目录通常要到 Writer.Close 才集中写入。也就是说，前面的 Write 没报错，只能说明当时写入的数据被接受，不能证明整个归档已经完成。

常见失败点包括底层磁盘空间耗尽、网络文件系统断连、写入器返回短写错误，或底层对象在归档结束前已经失效。忽略这个返回值，程序可能把一个不可读或缺索引的 ZIP 当成成功产物继续上传。

先把三层错误责任拆开

下面的最小函数只负责创建一个临时 ZIP。代码注释说明了每层的责任：文件内容写入失败时立即返回，归档 Writer 关闭失败时保留该错误，底层文件关闭失败则作为最后的资源错误返回。

package main

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

func writeZip(path string, name string, r io.Reader) (err error) {
    // 先创建输出文件；此时它只是临时产物，不能向调用方报告成功。
    file, err := os.Create(path)
    if err != nil {
        return err
    }
    defer func() {
        // 底层文件关闭失败不能覆盖更早的内容或 Writer.Close 错误。
        if closeErr := file.Close(); err == nil && closeErr != nil {
            err = closeErr
        }
    }()

    zw := zip.NewWriter(file)
    entry, err := zw.Create(name)
    if err != nil {
        return err
    }
    if _, err = io.Copy(entry, r); err != nil {
        return fmt.Errorf("写入 %s: %w", name, err)
    }
    // Close 会写中央目录；忽略它会把半成品误当成完整 ZIP。
    if err = zw.Close(); err != nil {
        return fmt.Errorf("完成 ZIP: %w", err)
    }
    return nil
}

这里使用命名返回值，是为了让延迟关闭函数在没有更早错误时补充底层 file.Close 的错误。它不是把所有错误“兜底吞掉”：如果内容写入或 zw.Close 已经失败，底层关闭错误不会覆盖更接近根因的错误。

用临时文件挡住 Close 失败的半成品

如果输出路径会被其他任务读取，直接写正式文件还有一个问题：即便最后发现 Writer.Close 失败，半成品已经暴露出去。更稳妥的边界是“写入临时文件—完成两个 Close—重命名”。

可以按下面的检查表实现发布逻辑：

重命名也要检查返回值；跨文件系统移动、权限变化或目标路径冲突都可能让最后一步失败。若业务还要上传 ZIP，上传动作应该放在重命名之后，并把本地成功、远端成功分别记录，避免用一个布尔值掩盖中间状态。

常见问题

Writer.Close 会自动关闭底层文件吗？

不会。它负责完成 ZIP 写入，但不关闭传入的底层 io.Writer，所以文件对象仍需由调用方关闭并检查错误。

只检查 os.File.Close 可以吗？

不可以。底层文件关闭成功不代表 ZIP 中央目录写入成功，Writer.Close 必须单独检查。

为什么不能用 defer zw.Close() 后直接返回 nil？

因为延迟调用的错误如果没有写回返回值，就会被丢弃；更糟的是调用方会收到成功状态。应显式关闭并在状态转换前处理返回值。

记住一个判断标准：只要归档的最后结构仍可能写入，就不能把 Writer.Close 当作形式动作。将它放在成功发布之前，并让失败产物停留在临时路径，才是可靠的 ZIP 输出边界。