.NET 6 Razor Pages：Ajax+MemoryStream下载服务器现有Excel失败求助

核心原因 #

Ajax请求本身无法直接触发浏览器的文件下载弹窗——XMLHttpRequest对象无法识别响应中的Content-Disposition下载头，即便后端正确返回了文件流，浏览器也不会自动处理。另外，读取现有文件到MemoryStream后若未重置流位置，会导致返回空流，也是常见问题。

解决方案 #

方案1：放弃Ajax，改用直接跳转/表单提交（推荐，最简单）

直接通过浏览器请求后端下载接口，绕过Ajax的限制：

后端PageModel代码

public IActionResult OnGetDownloadExistingExcel()
{
    // 服务器物理路径（替换为你的实际路径）
    string filePath = @"D:\PrivateFiles\sample.xlsx";

    if (!System.IO.File.Exists(filePath))
    {
        return NotFound("目标文件不存在");
    }

    // 读取文件到流，注意不要using包裹MemoryStream（FileStreamResult会自动处理关闭）
    var stream = new MemoryStream();
    using (var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read))
    {
        fileStream.CopyTo(stream);
    }
    // 重置流位置到起始处，否则返回空流
    stream.Position = 0;

    // 强制浏览器触发下载弹窗
    Response.Headers.Add("Content-Disposition", $"attachment; filename=\"sample.xlsx\"");

    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
}

前端代码（直接跳转）

<button onclick="window.location.href='/YourPageName?handler=DownloadExistingExcel'">下载现有Excel</button>

前端代码（带参数的POST表单提交，如需传文件名等参数）

<button onclick="downloadExcel()">下载现有Excel</button>

<script>
function downloadExcel() {
    const form = document.createElement('form');
    form.method = 'post';
    form.action = '/YourPageName?handler=DownloadExistingExcel';

    // 添加要传递的参数（比如文件名）
    const fileNameInput = document.createElement('input');
    fileNameInput.type = 'hidden';
    fileNameInput.name = 'fileName';
    fileNameInput.value = 'sample.xlsx';
    form.appendChild(fileNameInput);

    // 添加Razor Pages防伪造令牌
    const tokenInput = document.createElement('input');
    tokenInput.type = 'hidden';
    tokenInput.name = '__RequestVerificationToken';
    tokenInput.value = document.querySelector('input[name="__RequestVerificationToken"]').value;
    form.appendChild(tokenInput);

    document.body.appendChild(form);
    form.submit();
    document.body.removeChild(form);
}
</script>

方案2：保留Ajax，通过Base64转Blob实现下载（适合需前置验证的场景）

如果必须用Ajax先做逻辑验证，可让后端返回文件的Base64编码，前端再转成Blob触发下载：

后端PageModel代码

public IActionResult OnPostGetExcelBase64(string fileName)
{
    string filePath = @"D:\PrivateFiles\" + fileName;
    if (!System.IO.File.Exists(filePath))
    {
        return BadRequest("文件不存在");
    }

    byte[] fileBytes = System.IO.File.ReadAllBytes(filePath);
    string base64Str = Convert.ToBase64String(fileBytes);

    return new JsonResult(new {
        Base64Data = base64Str,
        FileName = fileName,
        ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
    });
}

前端Ajax代码

<button onclick="ajaxDownloadExcel()">Ajax下载Excel</button>

<script>
function ajaxDownloadExcel() {
    fetch('/YourPageName?handler=GetExcelBase64', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'RequestVerificationToken': document.querySelector('input[name="__RequestVerificationToken"]').value
        },
        body: JSON.stringify({ fileName: 'sample.xlsx' })
    })
    .then(res => res.json())
    .then(data => {
        // Base64转Blob
        const blob = base64ToBlob(data.Base64Data, data.ContentType);
        // 创建临时下载链接
        const url = window.URL.createObjectURL(blob);
        const a = document.createElement('a');
        a.href = url;
        a.download = data.FileName;
        document.body.appendChild(a);
        a.click();
        // 清理资源
        window.URL.revokeObjectURL(url);
        document.body.removeChild(a);
    })
    .catch(err => console.error('下载失败:', err));
}

// Base64转Blob工具函数
function base64ToBlob(base64Data, contentType = '', sliceSize = 512) {
    const byteChars = atob(base64Data);
    const byteArrays = [];
    for (let offset = 0; offset < byteChars.length; offset += sliceSize) {
        const slice = byteChars.slice(offset, offset + sliceSize);
        const byteNums = new Array(slice.length);
        for (let i = 0; i < slice.length; i++) {
            byteNums[i] = slice.charCodeAt(i);
        }
        byteArrays.push(new Uint8Array(byteNums));
    }
    return new Blob(byteArrays, { type: contentType });
}
</script>

注意事项 #

1. 确保应用池身份对服务器物理路径有读取权限，否则会出现文件访问拒绝错误。
2. 读取文件到MemoryStream后必须重置stream.Position = 0，否则返回的是空流。
3. 响应头Content-Disposition必须设置为attachment，否则浏览器可能直接打开文件而非触发下载。

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