ASP.NET Core返回FileContentResult正常但浏览器无文件下载问题咨询

问题成因 #

核心原因是AJAX请求本身不支持触发浏览器原生下载行为：浏览器仅在主动跳转URL、提交表单、触发a标签点击等场景下，会自动识别返回的文件流并唤起下载弹窗。通过AJAX调用下载接口时，返回的文件内容会被JavaScript作为普通响应数据接收，浏览器不会主动将其判定为待下载的文件，因此不会触发下载行为。

解决方法 #

方案1：直接跳转接口地址（最简便，适配现有代码） #

你当前的下载接口已经声明为[HttpGet]，完全不需要用AJAX调用，点击按钮时直接让浏览器跳转对应接口地址即可，不会导致当前页面刷新：

$('#downloadBtn').on('click', function() {
    // 替换为实际获取的任务ID
    const missionId = 5;
    window.location.href = `/Missions/DownloadMission/${missionId}`;
})

该方案无需修改后端代码，浏览器会自动识别返回的文件流，唤起下载弹窗。

方案2：AJAX接收流后动态触发下载（适配POST/复杂参数场景） #

如果需要传递复杂自定义配置参数，或者要求用POST请求，可以在AJAX回调中处理返回的二进制流，手动触发下载：

1. 前端调整AJAX配置，指定响应类型为blob，回调中动态创建临时下载链接：

$.ajax({
    url: '/Missions/DownloadMission',
    method: 'POST', // 可根据需求调整为POST
    data: { id: 5, /* 其他自定义配置参数 */ },
    xhrFields: {
        responseType: 'blob' // 必须指定响应类型为二进制流
    }
}).done(function(blob, status, xhr) {
    // 从响应头提取文件名，也可前端自定义
    const fileName = xhr.getResponseHeader('Content-Disposition')
        .split('filename=')[1]
        .replaceAll('"', '');
    // 生成临时资源链接
    const tempUrl = window.URL.createObjectURL(blob);
    // 动态创建a标签触发点击
    const tempLink = document.createElement('a');
    tempLink.href = tempUrl;
    tempLink.download = fileName;
    document.body.appendChild(tempLink);
    tempLink.click();
    // 清理临时资源
    window.URL.revokeObjectURL(tempUrl);
    document.body.removeChild(tempLink);
})

可选后端优化 #

如果需要直接返回JSON格式文件，可调整后端代码的文件名后缀和MIME类型，同时替换为UTF8编码避免中文乱码：

// GET: Missions/DownloadMission/5
[HttpGet, ActionName("DownloadMission")]
public FileContentResult DownloadMission(int id)
{
    Mission toDownload = db.Missions.Find(id);
    string json = JsonConvert.SerializeObject(toDownload);
    string fileName = $"{toDownload.Title}.json";
    string mimeType = "application/json";
    // 用UTF8编码避免中文乱码
    byte[] bytes = Encoding.UTF8.GetBytes(json);
    return File(bytes, mimeType, fileName);
}

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