tar.gz压缩失败主因是未调用gzip.Writer.Close()，导致gzip头尾缺失；路径穿越需用filepath.Clean()和Rel()校验；大文件应分块写入避免OOM；ModTime须显式赋值否则为1970年。
tar.gz 压缩失败：gzip.Writer 写入后必须调用 Close()
不调 Close()，生成的 .tar.gz 文件看似存在，但解压时大概率报 gzip: invalid header 或 “unexpected EOF”。因为 gzip.Writer 内部有缓冲，Write() 只是把数据塞进缓冲区，真正压缩并写入文件头/尾的工作在 Close() 里完成。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有
gzip.Writer实例（哪怕只写一个文件）都必须在tar.Writer关闭之后、文件句柄关闭之前调用Close() - 用
defer gw.Close()很危险——如果tar.Writer后续写入出错，gw.Close()仍会执行，但此时 gzip 流已损坏；更稳妥的是显式控制顺序：tw := tar.NewWriter(gw) // ... 写入 tar 包内容 tw.Close() // 先关 tar.Writer gw.Close() // 再关 gzip.Writer
- 忽略
gw.Close()返回的 error 是常见疏忽；它可能返回io.WriteShort或压缩层错误，应检查
archive/tar 不处理文件路径安全：手动过滤 ../ 防止路径穿越
tar.Writer.WriteHeader() 对 Header.Name 完全信任。如果传入 ../../etc/passwd，打包后解压就会覆写宿主机任意路径——这在服务端接收用户上传路径时是严重漏洞。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 对每个待打包的文件路径，用
filepath.Clean()标准化，再检查是否以..开头或包含/..、\.. - 更可靠的做法是限定根目录，用
filepath.Rel(root, absPath)获取相对路径，再验证结果是否含..：rel, err := filepath.Rel(root, fullPath) if err != nil || strings.Contains(rel, "..") || strings.IsAbs(rel) { return errors.New("unsafe file path") } - Windows 下注意路径分隔符差异，
filepath.FromSlash()或统一用filepath.ToSlash()归一化后再校验
大文件打包卡死：别用 io.Copy() 直接灌整个文件
对几百 MB 以上的文件，直接 io.Copy(tw, f) 会把整块内容读进内存再写入 tar 流，导致内存飙升甚至 OOM。而 tar.Writer 本身不提供流式 chunk 控制，需手动分块。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 改用固定 buffer（如 32KB）循环读写：
buf := make([]byte, 32*1024) for { n, err := f.Read(buf) if n > 0 { if _, writeErr := tw.Write(buf[:n]); writeErr != nil { return writeErr } } if err == io.EOF { break } if err != nil { return err } } - buffer 太小（如 1KB）会增加系统调用次数，影响性能；太大（如 1MB）又浪费内存；32KB ~ 128KB 是较平衡的选择
- 记得在每次
tw.Write()后检查 error，某些磁盘满或管道中断场景下会在此刻暴露
时间戳丢失：tar.Header 的 ModTime 必须显式赋值
默认创建的 tar.Header 中 ModTime 是零值（1970-01-01），解压后文件时间全变成 epoch 时间。这不是 bug，是 Go tar 包的设计选择——它不自动探测源文件时间。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Stat()获取源文件信息，赋给Header.ModTime：fi, _ := os.Stat(filePath) hdr, _ := tar.FileInfoHeader(fi, "") hdr.ModTime = fi.ModTime() // 显式设置，避免被忽略
- 注意
FileInfoHeader返回的hdr中ModTime已设为fi.ModTime()，但部分旧版 Go（ - 如果目标平台是 Windows，且需保留毫秒级精度，注意 tar 格式仅支持 1 秒精度，
ModTime.Truncate(time.Second)更稳妥
路径校验、gzip 关闭顺序、分块读取、时间戳赋值——这四个点漏掉任何一个，打包出来的 tar.gz 就可能在某个环节静默失败。尤其服务端批量打包时，错误常被日志吞掉，只剩用户反馈“解压不了”。
