Blazor 从服务器下载文件到客户端的方法

Blazor Server需通过JS互操作或API接口实现文件下载：小文件推荐Base64+Blob方式；大文件宜用临时URL或独立Controller流式响应；须注意中文文件名编码、内存开销与临时文件清理。

Blazor 服务端（Blazor Server）本身不直接支持传统 HTTP 文件下载（如 a href="xxx" download），因为它的交互基于 SignalR 长连接，没有标准的响应流上下文。但可以通过后端生成文件流 + 前端 JS 互操作的方式，安全、可靠地把文件“下载到客户端”。核心思路是：服务器准备好文件字节或路径 → 返回唯一标识或 Base64/URL → 客户端用 JS 触发浏览器原生下载。

方法一：返回文件字节流 + JS 创建 Blob 下载（推荐）

适用于小到中等大小文件（建议 ≤50MB），避免临时文件管理，内存可控。

• 在 Razor 组件中调用 C# 方法，比如点击按钮触发 DownloadReport()
• C# 后端生成文件内容（如 Excel、PDF、CSV），转为 byte[]，不保存到磁盘
• 通过 IJSRuntime.InvokeVoidAsync("downloadFromBytes", fileName, base64String) 把 Base64 字符串传给 JS
• JS 端用 atob() 解码，构造 Blob，再用 URL.createObjectURL() 和 a.click() 触发下载

方法二：生成临时文件 + 返回可访问 URL（适合大文件）

适合大文件或需复用、审计场景，但要注意清理和权限控制。

• 服务器将文件写入临时目录（如 Path.Combine(Path.GetTempPath(), Guid.NewGuid() + ".xlsx")）
• 注册一个静态文件中间件（UseStaticFiles）并配置临时目录为可公开访问路径（如 /downloads）
• 返回相对 URL（如 /downloads/abc123.xlsx），前端用 window.location.href 或隐藏 标签触发下载
• 务必添加过期清理逻辑（如后台定时任务或下载后立即删除），避免磁盘堆积

方法三：使用 Stream 实现流式响应（仅限 Blazor WebAssembly 不适用，Server 可配合 Controller）

如果项目同时有 ASP.NET Core API 控制器，可单独暴露一个 [HttpGet] /api/files/report 接口，返回 FileStreamResult，Blazor 组件用 NavigationManager.NavigateTo("/api/files/report", forceLoad: true) 跳转下载 —— 浏览器会自动处理响应头（Content-Disposition: attachment）。

• 优点：无需 JS 互操作，兼容性好，支持超大文件（无内存压力）
• 注意：必须确保该接口允许匿名访问或已携带有效认证凭据（如 Cookie

  

  自动附带）
• 不能用 HttpClient 直接请求（会读取响应体，无法触发下载）

注意事项与避坑点

无论哪种方式，都要注意：

• 文件名含中文时，C# 侧用 Uri.EscapeDataString(fileName) 编码，JS 侧用 decodeURIComponent() 解码，避免乱码
• Blazor Server 中不要在组件内直接调用 Response 或 HttpContext（SignalR 上下文不可用）
• Base64 方式传输大文件会增加约 33% 体积，且 JS 解码可能卡顿，慎用于 >20MB 场景
• 临时文件方案要加锁或唯一路径，防止并发覆盖或误删

基本上就这些。选哪种取决于文件大小、是否需要日志、部署环境限制——小文件优先用 Blob，大文件走 Controller 或临时 URL，简单直接又稳定。