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，简单直接又稳定。
