最稳妥方式是用 HttpClient 配合 Stream.CopyToAsync 流式下载并交由 BackgroundService 执行：设置超时、禁用内存加载、校验路径权限、记录日志，避免阻塞请求线程。
用 HttpClient 发起后台下载请求最稳妥
ASP.NET Core 中不推荐在 Controller 里直接用 FileStreamResult 或 FileContentResult 做“后台下载”，因为它们会阻塞请求线程、无法异步流式传输大文件。真正后台下载的核心是：发起一个**不依赖 HTTP 请求生命周期**的独立下载任务，比如从第三方 URL 拉取文件并保存到本地磁盘。
关键点在于用 HttpClient 配合 Stream.CopyToAsync 实现流式拉取，避免内存爆满：
- 必须用
using var http = new HttpClient();（或注入单例IHttpClientFactory），避免 socket 耗尽 - 务必设置
http.Timeout = TimeSpan.FromMinutes(10);，否则默认 100 秒超时容易中断大文件 - 不要调用
response.Content.ReadAsByteArrayAsync()——这是常见错误，会把整个文件加载进内存
var response = await http.GetAsync(downloadUrl, HttpCompletionOption.ResponseHeadersRead); response.EnsureSuccessStatusCode(); await using var stream = await response.Content.ReadAsStreamAsync(); await using var fileStream = File.Create(localFilePath); await stream.CopyToAsync(fileStream);
下载任务必须脱离 HTTP 上下文运行
用户点击“开始下载”后，Controller 只负责触发任务并立即返回响应（如任务 ID），不能等待下载完成。否则 IIS/Kestrel 会在超时后杀掉连接，导致下载中断且前端无感知。
推荐方式是写入持久化队列（如数据库记录 DownloadTask 状态为 Pending），再由后台服务（IHostedService）轮询执行：
- 不要用
Task.Run(() => DownloadAsync())—— 这类 fire-and-forget 在应用回收时会被静默终止 - 必须用
BackgroundService或Timer+CancellationToken支持优雅关闭 - 每个下载任务建议加唯一
downloadId，方便前端轮询进度或取消
如果只是临时轻量需求，可用 IServiceScopeFactory 创建新 scope 启动任务，但需自行管理异常和重试逻辑。
文件名、MIME 类型和断点续传要手动处理
后台下载不会自动继承源响应头，所以 Content-Disposition 和 Content-Type 都丢失了。你需要显式提取：
- 从
response.Content.Headers.ContentType?.MediaType获取 MIME 类型，存入数据库供后续提供下载用 - 若源站支持
Content-Disposition: attachment; filename="xxx.pdf"，可解析response.Content.Headers.ContentDisposition?.FileNameStar；否则 fallback 到 URL 最后一段或 UUID - 如需断点续传，下载前先检查本地文件是否存在，并用
Range头（http.DefaultRequestHeaders.Range = new RangeHeaderValue(resumePos, null)）继续拉取
注意：不是所有远端服务都支持 Range，调用前应先发 HEAD 请求验证 Accept-Ranges: bytes 响应头。
权限、路径和清理逻辑最容易出问题
后台服务运行身份（如 IIS 的 IIS AppPool\DefaultAppPool）可能没权限写入目标目录，或路径含非法字符（如 ../ 注入）。必须做严格校验：
- 本地保存路径用
Path.GetFullPath(savePath)+Path.GetDirectoryName()校验是否仍在允许根目录内（例如只允许写入C:\Downloads\下） - 文件名过滤掉
\ / : * ? " < > |等 Windows 非法字符，用Path.GetInvalidFileNameChars()辅助判断 - 下载失败时，残留的零字节文件必须
File.Delete()；成功后也建议设置清理策略（如 7 天过期自动删）
真正难的不是怎么下，而是怎么让每次下载都可追溯、可中断、可审计——日志里至少得记清 downloadId、源 URL、本地路径、耗时、HTTP 状态码和异常堆栈。
