c.DataFromReader是大文件并发下载的唯一可行路径，因c.File()会全量加载文件至内存导致OOM、无流控、不支持断点续传、无法前置鉴权；必须提前获取准确size、用url.PathEscape处理中文名、校验路径与权限后才调用，且响应头须在调用前全部设好。
c.DataFromReader 是大文件并发下载的唯一可行路径
别用 c.File() 做并发下载——100 个用户同时请求 100MB 文件，进程内存直接飙到 10GB，runtime: out of memory 不是警告，是必然结果。Gin 的 c.File() 底层调用 http.ServeFile，无流控、不支持断点续传、无法前置鉴权，纯属静态资源直出，不适合任何生产级下载场景。
真正支撑高并发大文件下载的，只有 c.DataFromReader()：它把 io.Reader 直接桥接到 HTTP 响应流，内存占用恒定（通常几 KB 缓冲区），天然适配并发压测。
- 必须提前获取准确
size参数，HTTP 协议强制要求Content-Length与实际字节数一致，否则 iOS Safari 拒载、断点续传失效、进度条卡死 - 若文件来自磁盘，用
os.Stat().Size()；若来自生成器（如 CSV 流），必须预知总大小，c.DataFromReader不支持Transfer-Encoding: chunked - 底层
io.Reader若不支持io.Seeker（例如gzip.NewReader），size错误会导致静默截断，且无日志提示
中文文件名在并发场景下必须用 url.PathEscape()
url.QueryEscape() 是错的——它把空格转成 +，Chrome 会解析失败并回退到乱码名；filename*=UTF-8'' 在 Gin 中需手动构造，但多数客户端（尤其旧版 Edge、微信内置浏览器）兼容性差，反而更不可靠。
正确做法是只用 url.PathEscape() 编码文件名，填入 Content-Disposition: attachment; filename="xxx" 字段。这是 URI path 编码规范，所有主流浏览器都认。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 错误示例：
c.Header("Content-Disposition", "attachment; filename="+url.QueryEscape("报告 2026.pdf"))→ 实际发送filename=报告+2026.pdf - 正确写法：
c.Header("Content-Disposition", "attachment; filename="+url.PathEscape("报告 2026.pdf")) - 注意：不要拼接
filename*=UTF-8''，Gin 不自动处理该字段，且c.DataFromReader()不接管 header 构造逻辑
并发下载前必须完成路径安全校验和权限检查
不能把鉴权逻辑放到 c.DataFromReader() 调用之后——一旦开始传输，就无法中断或撤回已发数据。所有校验（用户身份、文件归属、路径遍历防护）必须在打开文件前完成。
典型路径遍历漏洞发生在拼接用户输入时：filepath.Join(uploadRoot, c.Param("file")) 若未清理，../../etc/passwd 就能穿透根目录。
- 强制使用
filepath.Clean()+strings.HasPrefix()双重校验：先归一化路径，再确认清理后路径仍以白名单根目录开头 - 禁止通配符、禁止点号开头、禁止非预期扩展名（如只允许
.pdf和.xlsx） - 权限检查建议查 DB 或缓存，而非仅依赖文件系统权限——避免因 umask 或挂载选项导致的静默失败
响应头必须在调用 c.DataFromReader 前全部设置完毕
c.DataFromReader() 是“一锤子买卖”：一旦调用，HTTP header 就锁定发送，后续任何 c.Header() 都无效。常见错误是把 Content-Type 或 Content-Disposition 写在调用之后，结果浏览器渲染内容而非下载。
顺序错误还会导致 MIME 类型误判——比如 PDF 被当成 text/plain，中文字符全乱码；或者 Excel 被当成 application/octet-stream，双击打不开。
- 必须按顺序设置：
Content-Type→Content-Disposition→Content-Length→c.DataFromReader() - 推荐 MIME 类型参考：
application/pdf、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet、application/zip - 别漏
Cache-Control: no-cache，防止 CDN 或浏览器缓存陈旧文件
