如何在Blazor WASM中下载服务器上的现有文件？

问题场景 #

服务器wwwroot/files目录下存在export.xls文件，尝试用MemoryStream实现下载功能时失败，原代码片段：

await ms.WriteAsync(resFile.Content);
var res = new FileStreamResult(ms, "text/csv;charset=utf-8") { FileDownloadName = "export.xls" };
return res;

核心问题分析 #

1. MIME类型不匹配：将Excel文件错误标记为text/csv，浏览器无法正确解析文件格式
2. 流位置未重置：写入MemoryStream后，指针停留在流末尾，返回时无有效内容

可行解决方案 #

方案一：直接返回物理文件（推荐，高效简洁） #

利用ASP.NET Core的PhysicalFileResult直接返回磁盘上的文件，无需Stream中转：

var filePath = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot/files", "export.xls");
// 对应xls文件的正确MIME类型为application/vnd.ms-excel
return PhysicalFile(filePath, "application/vnd.ms-excel", "export.xls");

方案二：使用Stream的正确写法（适用于需预处理文件的场景） #

如果必须通过Stream处理，需重置流指针并使用正确MIME类型：

var filePath = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot/files", "export.xls");
using var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
var memoryStream = new MemoryStream();

await fileStream.CopyToAsync(memoryStream);
memoryStream.Position = 0; // 重置流指针到起始位置

return new FileStreamResult(memoryStream, "application/vnd.ms-excel") 
{ 
    FileDownloadName = "export.xls" 
};

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