http.ServeFile 不适合流式下载，因其一次性加载整个文件致OOM且无法动态生成内容；应使用 io.Copy 配合 io.Pipe 实现边读边写、内存恒定的流式响应，并正确设置 Content-Disposition 与超时策略。
为什么 http.ServeFile 不适合流式下载
它会一次性读取整个文件进内存，大文件直接 OOM；且无法动态生成内容（比如压缩包、日志实时打包）。真正流式下载必须绕过这个函数，手动控制响应体写入。
- 用
io.Copy配合os.Open或其他io.Reader源，边读边写，内存占用恒定 - 务必设置
Content-Disposition: attachment; filename="xxx"，否则浏览器可能尝试渲染而非下载 - 避免调用
w.Header().Set("Content-Length", ...)—— 流式场景下你往往不知道最终长度（如 gzip 压缩后、加密流、数据库游标读取）
如何用 io.Pipe 实现动态内容流式生成
当文件内容不是磁盘上现成的，而是需要运行时拼接、压缩、加密或从数据库逐行读取时，io.Pipe 是最轻量的解耦方式。
- 创建管道：
pr, pw := io.Pipe()，pr作为响应体 reader，pw在 goroutine 中写入 - 立即把
pr写入http.ResponseWriter，再启动 goroutine 向pw写数据，出错时记得调用pw.CloseWithError(err) - 不要在 handler 主 goroutine 等待写入完成——这会阻塞 HTTP 连接复用，导致并发下降
// 示例：动态生成 CSV 流
func csvDownload(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/csv; charset=utf-8")
w.Header().Set("Content-Disposition", `attachment; filename="data.csv"`)
<pre class="brush:php;toolbar:false;">pr, pw := io.Pipe()
defer pr.Close()
go func() {
defer pw.Close()
w := csv.NewWriter(pw)
for _, row := range getRowsFromDB() {
if err := w.Write(row); err != nil {
pw.CloseWithError(err)
return
}
}
w.Flush()
}()
io.Copy(w, pr)}
大文件下载时如何避免超时和连接中断
默认 HTTP 超时（如 Go 的 http.Server.ReadTimeout）和反向代理（Nginx、ALB）的 idle timeout 都可能在传输中途切断连接。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 服务端：设置
http.Server.ReadTimeout和WriteTimeout为足够长的值（如 30 分钟），但更推荐用IdleTimeout+ReadHeaderTimeout组合，避免影响小请求 - 客户端：浏览器一般不主动断开，但移动端或弱网下需加心跳。可在流中定期写入注释行（如
# keepalive\n）并设Flush()，防止中间设备误判空闲 - Nginx 配置需同步调整：
proxy_read_timeout 1800;、proxy_buffering off;，否则它会缓存整个响应再吐给客户端
流式下载里 Content-Length 和 Transfer-Encoding: chunked 怎么选
如果文件大小确定且无需压缩/加密，显式设 Content-Length 更高效（HTTP/1.1 复用、客户端可显示进度）；否则必须依赖 chunked 编码，这是 Go net/http 默认行为（只要你不设 Content-Length 且没关闭连接）。
- 设了
Content-Length但实际写入字节数不匹配 → 连接被静默截断，客户端收不到完整数据 - gzip 响应下不能手动设
Content-Length，因为压缩后长度不可预知；此时应删掉该 header，让 Go 自动切 chunk - 用
ResponseWriter.(http.Hijacker)强制 chunked？没必要。Go 默认已处理，除非你在写原始 TCP 流
流式下载真正的难点不在代码几行，而在于上下游协同：你得确认 Nginx 不缓存、CDN 不拦截、客户端不因空闲断连、错误发生时能 clean 关闭 pipe。漏掉任一环，都会表现为“下载到一半卡住”或“文件损坏”。
