返回文件流需使用File方法，1. 本地文件通过Filestream读取并返回；2. 内存文件用MemoryStream生成，注意重置position；3. 设置正确MIME类型以控制浏览器行为；4. 大文件推荐异步读取，提升性能。
在 .net Web API 中返回文件流，通常用于提供文件下载功能，比如导出报表、下载图片或文档等。核心是使用 FileStreamResult 或其基类 FileResult，结合 ControllerBase.File 方法来实现。
1. 返回本地文件流
如果文件存储在服务器本地路径中，可以通过 FileStream 打开并返回：
[HttpGet("download")] public IActionResult DownloadFile() { var filePath = @"C:uploadsexample.pdf"; var fileExists = System.IO.File.Exists(filePath); <pre class='brush:php;toolbar:false;'>if (!fileExists) return NotFound("文件未找到"); var stream = new FileStream(filePath, FileMode.Open, Fileaccess.Read); var contentType = "application/pdf"; var fileName = "example.pdf"; return File(stream, contentType, fileName);
}
说明：
– File(stream, contentType, fileName) 是 ControllerBase 提供的便捷方法。
– 浏览器接收到响应后会根据文件名触发下载。
– contentType 决定浏览器如何处理该文件（如显示或下载）。
2. 返回内存中的文件流（MemoryStream）
适用于动态生成的文件，例如导出 excel、PDF 或压缩包：
[HttpGet("export")] public IActionResult ExportData() { var memoryStream = new MemoryStream(); // 模拟写入数据 var data = "Hello, this is exported content."; var bytes = Encoding.UTF8.GetBytes(data); memoryStream.Write(bytes, 0, bytes.Length); memoryStream.Position = 0; <pre class='brush:php;toolbar:false;'>return File(memoryStream, "text/plain", "data.txt");
}
注意：MemoryStream 必须将 Position 重置为 0，否则读取不到内容。
3. 设置响应头优化下载体验
可以手动控制响应行为，比如强制下载而不尝试在浏览器中打开：
实际效果由浏览器决定，但设置合适的 MIME 类型和文件扩展名能提高准确性。
常见 MIME 类型示例：
– .txt → text/plain
– .pdf → application/pdf
– .xlsx → application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
– .zip → application/zip
4. 异步方式返回文件流（推荐）
对于大文件或 I/O 密集操作，建议使用异步方法提升性能：
[HttpGet("download-async")] public async Task<IActionResult> DownloadFileAsync() { var filePath = @"C:uploadslargefile.zip"; <pre class='brush:php;toolbar:false;'>if (!System.IO.File.Exists(filePath)) return NotFound(); var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true); return File(stream, "application/zip", "download.zip");
}
.NET 会自动管理流的释放，无需手动调用 Dispose()。
基本上就这些。只要正确使用 File() 方法传入流、MIME 类型和文件名，就能让 Web API 成功返回文件流。