Revel中用Controller.RenderFile下载本地文件最稳妥：需用filepath.Join拼绝对路径并校验可读性，禁止用户输入直拼防路径穿越；中文文件名须手动设Content-Disposition为filename*=UTF-8''+url.PathEscape()格式；Nginx反代时需配置透传头并禁用缓冲。
Revel 中用 Controller.RenderFile 下载本地文件最稳妥
Revel 框架原生支持直接返回磁盘文件，Controller.RenderFile 是最简单、最安全的下载方式。它内部自动设置 Content-Type、Content-Length 和 Content-Disposition，避免手动拼接响应头出错。
常见错误是传入相对路径或未校验文件是否存在，导致 404 或 500 错误。正确做法是：用 filepath.Join 拼接绝对路径，并先检查文件可读性。
- 确保文件路径在 WebRoot（如
app/conf/app.conf中配置的app.path）下或显式指定可信目录，禁止接收用户输入直接拼路径，防路径穿越 - 不要用
os.Open后手动读取再写响应体——这会绕过 Revel 的流式处理，易内存溢出且无法断点续传 - 若需自定义文件名（含中文），
RenderFile默认使用原始文件名；如需覆盖，得改写响应头，但必须在调用前完成：c.Response.Header().Set("Content-Disposition", "attachment; filename*=UTF-8''" + url.PathEscape("报告.pdf"))
大文件或动态生成内容用 StreamingResponse 避免内存堆积
当文件来自数据库 BLOB、实时压缩结果或远程 API 流时，RenderFile 不适用。Revel 提供 c.Result = &revel.StreamingResponse{...}，允许你传入一个 io.Reader，框架按 chunk 推送数据，不全量加载进内存。
关键陷阱在于：流未关闭、Content-Type 设错、或提前写入响应体导致状态码失效。Revel 的 StreamingResponse 要求你明确指定 ContentType 和 Filename 字段，否则浏览器可能当成 text/html 打开。
-
ContentType必须准确，比如 PDF 用"application/pdf"，CSV 用"text/csv; charset=utf-8"，否则 IE/Edge 可能拒绝下载 - 若流来自
http.Get响应体，别直接返回resp.Body——它没设Content-Length，浏览器无法显示进度；建议用io.Copy到revel.ResponseWriter并手动设Content-Length（如果已知） - 不要在
StreamingResponse外再调用c.RenderError或c.RenderJSON，响应已提交，会 panic
中文文件名乱码？必须用 filename* 标准格式
Revel 默认的 Content-Disposition: attachment; filename="xxx" 对中文名无效，Chrome/Firefox 会显示为乱码或截断。HTTP/1.1 RFC 5987 要求使用 filename*=UTF-8''xxx 编码格式。
Revel 不自动处理这个，你得手动覆盖响应头。注意：不能同时设 filename 和 filename*，否则旧版 Safari 可能出错；优先只设 filename*。
- 用
url.PathEscape编码文件名，不是url.QueryEscape—— 后者会把空格转成+，不符合 RFC - 示例：
c.Response.Header().Set("Content-Disposition", "attachment; filename*=UTF-8''" + url.PathEscape("订单汇总-202610.xlsx")) - 测试时务必用真实浏览器（非 curl），curl 不解析
filename*，会退回到filename字段
Nginx 反向代理下，Content-Length 和 Transfer-Encoding 易被吞掉
生产环境 Revel 通常跑在 Nginx 后面。Nginx 默认对非 200 响应或 chunked 响应会移除 Content-Length，并可能重写 Content-Disposition，导致下载中断或文件名丢失。
这不是 Revel 的 bug，而是反向代理的默认行为。必须显式配置 Nginx 透传关键头。
- 在 location 块里加：
proxy_pass_request_headers on;和proxy_buffering off;（后者防止 Nginx 缓存整个响应体） - 强制透传头：
proxy_hide_header Content-Length;要删掉；如果用了gzip on，关掉它或加gzip_disable "msie6";，IE 下 gzip + 下载易损坏 - 最保险的做法：让 Revel 返回带
Content-Length的静态文件（RenderFile），Nginx 默认会保留该头；动态流则考虑在 Nginx 层加add_header Content-Disposition $sent_http_content_disposition;显式透传
