Blazor Server上传Excel后生成的Excel无法自动下载问题排查

核心原因 #

1. Blazor Server通信机制限制：Blazor Server基于SignalR双向通信，而Radzen Upload的上传请求本质是AJAX请求。浏览器不会自动处理AJAX请求返回的FileResult——这类请求的响应是交给前端JS处理的，而非浏览器直接解析下载头触发弹窗。
2. 缺少前端主动触发逻辑：控制器返回的Excel文件数据没有被前端代码捕获并处理，AJAX请求完成后不会自动触发下载动作，必须由前端主动调用浏览器的下载API。
3. 响应头无效场景：如果控制器未正确设置Content-Disposition（如未指定attachment）或Content-Type，也可能导致浏览器不识别下载请求，但你提到无报错，这种概率较低，核心还是前两点。

解决方法（基于IJSRuntime实现，符合Blazor Server最佳实践） #

方案1：上传完成后通过IJSRuntime触发前端下载（推荐） #

这种方式完全适配Blazor Server的通信模式，无需页面刷新。

步骤1：修改UploadController返回JSON数据

不再直接返回FileResult，而是将生成的Excel转为Base64字符串，返回包含文件信息的JSON：

[HttpPost]
public IActionResult Upload(IFormFile file)
{
    // 1. 处理上传的Excel，生成包含重复记录的新Excel文件
    using var memoryStream = new MemoryStream();
    // 假设此处用EPPlus/NPOI等库生成Excel，示例逻辑省略
    // ...生成Excel到memoryStream...
    
    memoryStream.Position = 0;
    var fileBase64 = Convert.ToBase64String(memoryStream.ToArray());

    // 返回文件信息
    return Json(new 
    { 
        FileBase64 = fileBase64,
        FileName = "重复记录汇总.xlsx",
        MimeType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
    });
}

步骤2：在Razor页面处理上传完成事件，调用IJSRuntime

在Radzen Upload的Complete回调中解析控制器返回的JSON，然后调用JS函数触发下载：

<RadzenUpload Url="/Upload/Upload" Complete="@OnUploadComplete" />

@code {
    [Inject] private IJSRuntime JSRuntime { get; set; }

    private async Task OnUploadComplete(UploadCompleteEventArgs args)
    {
        var downloadInfo = await args.HttpResponse.Content.ReadFromJsonAsync<FileDownloadInfo>();
        if (downloadInfo != null)
        {
            // 调用自定义JS函数下载文件
            await JSRuntime.InvokeVoidAsync(
                "downloadFromBase64", 
                downloadInfo.FileName, 
                downloadInfo.MimeType, 
                downloadInfo.FileBase64
            );
        }
    }

    // 用于解析JSON的模型类
    private class FileDownloadInfo
    {
        public string FileBase64 { get; set; }
        public string FileName { get; set; }
        public string MimeType { get; set; }
    }
}

步骤3：添加前端JS下载函数

在wwwroot/js/site.js（或自定义JS文件）中添加处理Base64并触发下载的函数：

function downloadFromBase64(fileName, mimeType, base64Data) {
    // 解码Base64为二进制数据
    const byteChars = atob(base64Data);
    const byteNumbers = new Array(byteChars.length);
    for (let i = 0; i < byteChars.length; i++) {
        byteNumbers[i] = byteChars.charCodeAt(i);
    }
    const byteArray = new Uint8Array(byteNumbers);
    
    // 创建Blob并触发下载
    const blob = new Blob([byteArray], { type: mimeType });
    const url = URL.createObjectURL(blob);
    const link = document.createElement('a');
    link.href = url;
    link.download = fileName;
    document.body.appendChild(link);
    link.click();
    // 清理资源
    document.body.removeChild(link);
    URL.revokeObjectURL(url);
}

方案2：跳转至下载Action（不推荐，会刷新页面） #

如果坚持通过控制器返回FileResult，可以在上传完成后跳转至专门的下载接口，但会破坏Blazor的SPA体验：

步骤1：控制器添加下载接口

先将生成的Excel保存到服务器临时路径，再提供下载接口：

private readonly string _tempPath = Path.GetTempPath();

[HttpPost]
public IActionResult Upload(IFormFile file)
{
    var tempFileName = $"temp_{Guid.NewGuid()}.xlsx";
    var tempFilePath = Path.Combine(_tempPath, tempFileName);

    // 生成Excel并保存到临时路径
    using var stream = new FileStream(tempFilePath, FileMode.Create);
    // ...生成Excel到stream...

    // 返回临时文件名，供后续下载使用
    return Json(new { TempFileName = tempFileName });
}

[HttpGet]
public IActionResult Download(string tempFileName)
{
    var tempFilePath = Path.Combine(_tempPath, tempFileName);
    if (!System.IO.File.Exists(tempFilePath))
    {
        return NotFound();
    }

    var memoryStream = new MemoryStream();
    using var fileStream = new FileStream(tempFilePath, FileMode.Open);
    fileStream.CopyTo(memoryStream);
    memoryStream.Position = 0;

    // 删除临时文件（可选）
    System.IO.File.Delete(tempFilePath);

    return File(
        memoryStream, 
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", 
        "重复记录汇总.xlsx"
    );
}

步骤2：上传完成后跳转至下载接口

private async Task OnUploadComplete(UploadCompleteEventArgs args)
{
    var result = await args.HttpResponse.Content.ReadFromJsonAsync<TempFileResult>();
    if (result != null)
    {
        // 通过JS打开新窗口触发下载
        await JSRuntime.InvokeVoidAsync(
            "window.open", 
            $"/Upload/Download?tempFileName={result.TempFileName}", 
            "_blank"
        );
    }
}

private class TempFileResult
{
    public string TempFileName { get; set; }
}

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