c.file()不能用于动态生成pdf，因其仅支持读取磁盘已有文件，而gofpdf/unidoc生成的是运行时字节流，未落地存储；直接写入http响应需前置设置content-type、中文字体及addpage，并禁用压缩以避免oom。
为什么c.File()不能用于动态生成的PDF
因为 c.File() 只能读取磁盘上已存在的文件，而动态 PDF 是运行时用 gofpdf 或 unidoc 生成的字节流，没落地到文件系统。直接调 c.File("./temp/report.pdf") 不仅多出 I/O 开销，还可能因并发写入冲突、临时文件清理不及时导致 404 或脏数据。
用gofpdf生成PDF并直接写入HTTP响应体
核心是把 gofpdf.PdfGenerator 的输出目标从文件改为 http.ResponseWriter，跳过本地存储环节。关键点有三个：响应头顺序、Content-Type 设置、中文字体注册必须前置。
- 必须在调用
pdf.Output(w)前设置全部 header，否则会被忽略 -
Content-Type设为application/pdf，不是octet-stream（后者会让 Chrome 弹保存框但无法预览） - 中文标题/内容前，先
pdf.AddFont("noto", "", "./fonts/NotoSansCJKsc-Regular.ttf")再pdf.SetFont("noto", "", 12) - 调用
pdf.AddPage()是强制步骤，漏掉则输出为空白 PDF
处理中文文件名下载和缓存问题
浏览器对 Content-Disposition 中文 filename 的解析差异大，Chrome 和 Edge 支持 filename*=UTF-8''... 编码，Safari 仍倾向 fallback 到 ASCII 文件名。同时 CDN 或 Nginx 可能缓存旧版 PDF，导致用户反复下载到过期报告。
- 文件名编码用
url.PathEscape("巡检报告_20260813.pdf")生成安全路径片段 - 完整 header 写法：
c.Header("Content-Disposition", "attachment; filename*=UTF-8''" + encodedName) - 加
c.Header("Cache-Control", "no-store, must-revalidate")确保不被中间件缓存 - 避免用
c.Writer.WriteHeader(http.StatusOK)手动设状态码——pdf.Output(w)内部已处理，重复设会 panic
大报告导出卡顿或内存溢出怎么办
单次生成百页 PDF 容易触发 Go runtime GC 压力或 OOM，尤其含图表图片时。gofpdf 默认启用压缩，对大文档反而增加 CPU 负担；且所有内容都缓存在内存 buffer 中才输出，无法流式传输。
- 禁用压缩：
pdf := gofpdf.New("P", "mm", "A4", "")后立刻pdf.Compress = false - 分页生成时，每页调一次
pdf.AddPage()，不要等全部内容写完再 Output - 图表 PNG 优先用
pdf.ImageFromBytes()加载bytes.Buffer，而非磁盘路径——避免 Docker 容器内路径不可达 - 超长文本用
MultiCell()时预估宽度：中文字体下，12 号字 ≈ 每字符 2.5mm，列宽按此反推，避免换行错位
真正麻烦的是字体注册路径和 AddPage 调用时机——这两个点出错，PDF 生成静默失败，连 error 都不返回，只能靠日志打点确认是否执行到对应行。
