必须用c.datafromreader而非c.file或c.data，因后两者调用io.readall一次性加载全文件到内存，100mb文件×400并发即oom；c.datafromreader支持流式传输并需显式设置content-length、content-disposition及及时关闭文件句柄。
大文件下载必须用 c.DataFromReader，而不是 c.File 或 c.Data —— 否则单个 100MB 请求就吃掉 100MB 内存，400 并发直接 OOM。
为什么 c.File 在微服务里根本不能用
它底层调用 io.ReadAll 把整个文件读进内存再写响应体，和流式无关。微服务场景下尤其危险：服务通常部署在资源受限的容器中（如 2GB 内存），而一个 c.File("./report.zip") 调用可能让单实例瞬间崩溃。
- 现象：wrk 压测时 RSS 持续上涨，
pprof显示io.ReadAll占 heap 95%+，GC 频繁但内存不释放 - 兼容性陷阱：Windows 下
sendfile不生效，但c.DataFromReader仍能保流式；Linux 下可进一步配合http.ServeContent启用内核零拷贝 - 断点续传失效：因为
c.File不解析Range头，也不设置Content-Range，浏览器重试时只能重下整份
c.DataFromReader 的正确初始化姿势
不是简单套个 os.Open 就完事。必须显式获取文件元信息、校验可读性、设置响应头，否则下游代理或 CDN 可能缓存错误内容或拒绝传输。
- 必须调用
f.Stat()获取Size()，传给c.DataFromReader的第二个参数；传错会导致Content-Length错误，HTTP/2 流被 reset - 必须手动设
Content-Disposition，否则某些浏览器（如 Safari）会尝试解析二进制为文本并报错 - 避免 defer f.Close() 在 handler 返回后才执行——应确保在
c.DataFromReader调用前或调用中 close，否则文件句柄泄漏
示例关键段：
f, err := os.Open(filepath)
if err != nil {
c.AbortWithStatusJSON(http.StatusNotFound, gin.H{"error": "file not found"})
return
}
defer f.Close()
stat, err := f.Stat()
if err != nil {
c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "stat failed"})
return
}
c.Header("Content-Type", "application/octet-stream")
c.Header("Content-Disposition", "attachment; filename="+filepath.Base(filepath))
c.DataFromReader(http.StatusOK, stat.Size(), "application/octet-stream", f, nil)
微服务链路中的流式穿透问题
当 Gin 作为微服务网关或边缘服务时，上游（如 Nginx、Envoy）或下游（如另一个 Go 服务）可能缓冲响应体，导致你写了流式，实际仍是全量加载。
- Nginx 默认开启
proxy_buffering on，会等整个响应结束才转发；需配proxy_buffering off+chunked_transfer_encoding on - 如果下游是另一个 Gin 服务且用了
c.ShouldBindJSON解析上传，注意它也会全量读 body —— 此时流式只到第一跳，第二跳又变阻塞 - Gin 自身中间件若调用了
c.Request.Body（比如自定义鉴权读 token）、或用了c.MustGet("xxx")但没检查 key 是否存在，都可能提前触发 body 读取
流式 + 并发控制的实际边界
流式解决的是内存恒定，不是无限并发。磁盘 I/O 和网络带宽仍是瓶颈，尤其当多个大文件同时下载时。
- Linux 下建议启用
sendfile：确保c.Writer未被中间件提前写入（比如日志中间件调了c.Writer.Size()就会破坏 sendfile 路径） - Worker Pool 必须隔离：文件打开、stat、header 设置这些操作可同步做，但
c.DataFromReader调用本身不能丢进 goroutine ——gin.Context不跨协程安全 - 真实压测发现：即使流式，单机 4K 并发下载 100MB 文件时，千兆网卡打满、iowait 升高，此时加机器比调优代码更有效
最易被忽略的一点：流式传输不等于流式解析。如果你在下载路径里顺手做了 ZIP 解包或 CSV 行解析，那依然会把整块数据 load 进内存 —— 流式只管“送出去”，不管“读进来”或“算什么”。
