http.servefile不能用于大文件导出，因其一次性加载整个文件进内存，易触发oom；必须改用io.copy+responsewriter流式传输，并配合分块、超时控制、并发隔离与安全校验。
大文件导出为什么不能直接 http.ServeFile？
因为 http.ServeFile 会一次性读取整个文件进内存，1GB 文件就可能吃光服务内存、触发 GC 频繁或 OOM。微服务场景下还要考虑超时、并发、下游断连等问题，必须用流式（io.Copy + ResponseWriter）+ 分块（chunked encoding 或自定义分片）。
关键点不是“能不能传”，而是“传的过程中能否不崩、不断、不卡住其他请求”。
- HTTP 超时默认常为 30s，大文件导出必须显式设置
http.Server.ReadTimeout和WriteTimeout - 避免在 handler 中调用
file.Stat()后再os.Open()—— 文件可能被删/重命名，应直接os.Open并检查os.IsNotExist(err) - 不要用
bytes.Buffer拼接大文件内容，它会全量驻留内存；改用io.MultiReader或按需生成分块数据
如何实现分块打包：用 archive/zip 的 zip.Writer 流式写入
archive/zip 本身支持边写边 flush，但默认不会自动分块；要让下游能边收边解压（或断点续传），得控制写入节奏，并暴露分块边界信息（如每个 chunk 的 offset + size）。
实际做法是：不把整个 zip 写死到一个 ResponseWriter，而是封装一个带缓冲的 io.WriteCloser，每次写入 2MB 数据后主动 Flush()，并记录当前已写入字节数。
- 启用 HTTP 分块传输编码：
w.Header().Set("Content-Transfer-Encoding", "binary")，并确保没设Content-Length（否则禁用 chunked） - 用
zip.NewWriter包裹responseWriter，每添加一个文件后调用w.Flush()，强制刷出局部 zip 结构 - 若需支持断点续传，应在响应头中加
Content-Range和Accept-Ranges: bytes，但这要求后端能按 range 精确定位 zip 内文件偏移 —— 实现复杂，建议改用分片下载接口（如/export/{job_id}/part/{n}）
怎么处理并发导出和资源隔离？
多个大文件导出同时跑，容易打满 goroutine、fd 或磁盘 IO。不能靠“加机器”硬扛，得从设计上做隔离。
- 用带缓冲的 channel 控制并发数，例如
sem := make(chan struct{}, 5)，每个导出任务先sem ，结束后 <code> - 避免共用同一个
*os.File句柄 —— 即使是只读，多 goroutine 并发Read()仍可能因内核 page cache 竞争变慢；建议每个任务独立os.Open - 临时文件路径必须唯一：
os.CreateTemp("/tmp/export", "zip-*.zip")，且务必用defer os.Remove(path)清理（注意：若导出失败或中断，需额外加 context cancel 清理逻辑） - 不要用
log.Printf在导出循环里打高频日志 —— 日志 I/O 会拖慢整个流；改用结构化日志 + 采样（如每 10MB 打一条进度 log）
客户端收到的 zip 为什么打不开？常见校验陷阱
流式 zip 最容易出的问题不是“传不完”，而是“传完了但 zip 校验失败”—— 因为 zip 文件末尾有 central directory，必须在流结束前完整写出。如果 handler panic、context 超时或连接提前关闭，zip.Writer.Close() 就没机会执行，zip 就是损坏的。
- 必须在 defer 中调用
zipWriter.Close()，且检查返回 err；若 err != nil，应记录并尝试向 client 写入错误提示（但注意：此时 response 可能已部分写出，只能写入 error trailer 或丢弃） - 不要依赖
http.Error()在中途报错 —— 它会清空已写 header/body；正确做法是用http.Hijacker或改用 streaming JSON error envelope（如开头写{"status":"error",...}） - 前端 JS 下载时，若用
fetch().then(res => res.blob())，blob 构造后无法校验 zip 完整性；建议后端加个X-Zip-Checksum: sha256=xxxheader，前端下载完再比对
最易被忽略的一点：gzip 压缩中间件（如 gin-contrib/gzip）会破坏 zip 二进制流完整性，必须对导出路径显式禁用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
