C#服务端生成PDF临时文件后如何实现客户端侧文件下载

WebClient.DownloadFile 是服务端执行的方法，运行环境为Web服务器本身，执行时只会把文件写入服务器的本地磁盘路径，完全不会和用户浏览器产生交互，因此用户侧不会收到任何下载提示，也拿不到生成的PDF文件。

服务端代码没有权限直接操作用户的本地文件系统，所有触发用户端下载的逻辑，都需要通过构造带附件标识的HTTP响应实现，浏览器收到对应响应后会自动弹出下载提示，由用户确认后将文件存入本地目录。

推荐方案：不落临时文件，直接返回PDF流 #

从page.PdfAsync方法判断你使用的是PuppeteerSharp组件，它原生支持直接生成PDF到内存流，不需要在服务端写临时文件，性能更好也没有磁盘清理负担：

// 直接生成PDF到内存流，无需落地服务端磁盘
using var pdfStream = await page.PdfStreamAsync();
// 构造文件响应，指定PDF类型和下载文件名
return File(pdfStream, "application/pdf", $"{id}.pdf");

兼容原有临时文件逻辑的实现 #

如果你需要保留原有生成临时PDF的逻辑，读取临时文件字节流返回即可，记得返回前删除临时文件避免占用服务器磁盘：

// 原有生成临时PDF的逻辑
string tempPdfPath = System.IO.Path.Combine(Path.GetTempPath(), $"{id}.pdf");
await page.PdfAsync(tempPdfPath);

// 读取临时文件内容
byte[] pdfBytes = await File.ReadAllBytesAsync(tempPdfPath);
// 及时删除服务端临时文件
File.Delete(tempPdfPath);

// 返回文件响应触发浏览器下载
return File(pdfBytes, "application/pdf", $"{id}.pdf");

传统ASP.NET Framework（非Core）适配代码 #

如果你用的是老版本.NET Framework，没有内置的File返回方法，可以直接操作响应对象实现：

string tempPdfPath = Path.Combine(Path.GetTempPath(), $"{id}.pdf");
await page.PdfAsync(tempPdfPath);
byte[] pdfBytes = File.ReadAllBytes(tempPdfPath);
File.Delete(tempPdfPath);

Response.Clear();
Response.ContentType = "application/pdf";
Response.AddHeader("Content-Disposition", $"attachment; filename=\"{id}.pdf\"");
Response.BinaryWrite(pdfBytes);
Response.Flush();
Response.End();

• 不要尝试在服务端代码中编写直接写入用户本地路径的逻辑，受浏览器安全沙箱和网络架构限制，服务端没有权限直接访问用户设备的文件系统
• 若使用临时文件方案，必须在返回响应前完成临时文件删除逻辑，避免长时间运行后占满服务器磁盘
• 响应头中Content-Disposition设为attachment是触发浏览器下载行为的关键，如果设为inline浏览器会尝试直接在页面内预览PDF而非触发下载

内容的提问来源于stack exchange，提问作者Michael1834