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

来源：这里教程网时间：2026-02-21 17:40:34 作者：

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
或隐藏
<a></a>
标签触发下载 务必添加过期清理逻辑（如后台定时任务或下载后立即删除），避免磁盘堆积

方法三：使用 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，简单直接又稳定。