Blazor 怎么实现文件下载

Blazor文件下载分服务端返回（推荐，适用于权限校验、动态生成、大文件流式传输）和前端Blob触发（适合小文件或已加载数据）两种方式，关键在于正确设置Content-Disposition响应头或使用JS互操作生成Blob下载。

Blazor 实现文件下载主要有两种场景：服务端生成/读取文件后返回（常用），以及前端直接触发浏览器下载（如 Blob）。核心是让浏览器拿到文件内容并触发保存对话框，关键在于正确设置响应头和传输方式。

服务端返回文件（推荐，适用于大多数情况）

这是最稳妥的方式，尤其适合需要权限校验、动态生成、大文件流式传输等场景。Blazor Server 或 Blazor WebAssembly 都可通过 HTTP 请求调用后端 API 下载文件。

• 后端（如 ASP.NET Core Controller）返回 FileResult，例如 FileStreamResult、PhysicalFileResult 或 FileContentResult
• 确保设置正确的 Content-Disposition 响应头（含 attachment; filename="xxx"），否则浏览器可能尝试内嵌打开而非下载
• Blazor 客户端用 NavigationManager.NavigateTo(url, forceLoad: true) 直接跳转到下载接口 URL——这是最简单可靠的方式，无需 JS 互操作

前端触发下载（适合小文件或已加载的二进制数据）

当文件内容已在前端（比如用户上传后处理、JSON 导出为 CSV、Canvas 导出图片），可用 JavaScript 互操作生成 Blob 并下载。

标签： javascript java html js 前端 json 编码 浏览器 app 后端 csv ai stream