MVC中使用Html.ActionLink下载文件：如何处理并上报下载失败

针对你遇到的问题，这里有两个实用方案，能实现文件无效时显示提示，避免用户下载空文件：

方案1：先校验文件有效性，再触发下载 #

先通过AJAX请求确认文件是否可下载，验证通过后再触发原来的下载链接，不用改动太多原有逻辑。

具体步骤： #

1. 调整视图按钮：保留原来隐藏的ActionLink，新增一个可见的触发按钮：

<button id="download-trigger">下载文件</button>
@Html.ActionLink("Connect", "DownloadFile", "Results", new { ResultID = Model.Result.ResultID }, new { @id = "connect-btn", @style = "display:none"})

2. 写JS校验逻辑：点击触发按钮时，先调用校验接口，带上AntiForgeryToken：

$("#download-trigger").click(function() {
    // 页面里要确保有@Html.AntiForgeryToken()，不然拿不到token
    var token = $('input[name="__RequestVerificationToken"]').val();
    $.ajax({
        url: '@Url.Action("CheckFileValid", "Results")',
        type: 'POST',
        data: { 
            ResultID: '@Model.Result.ResultID',
            __RequestVerificationToken: token
        },
        success: function(res) {
            if (res.isValid) {
                // 校验通过，触发隐藏的下载链接点击
                $("#connect-btn")[0].click();
            } else {
                // 显示失败提示，你可以换成页面元素展示
                alert("下载失败");
            }
        },
        error: function() {
            alert("下载失败");
        }
    });
});

3. 加控制器校验方法：把原来判断文件是否有效的逻辑抽出来，写个新的Action：

[HttpPost]
[ValidateAntiForgeryToken]
public JsonResult CheckFileValid(int ResultID)
{
    bool isValid = false;
    // 这里复用你原来DownloadFile里获取流、判断是否为空的逻辑
    using (var stream = GetFileStream(ResultID))
    {
        if (stream != null && stream.Length > 0)
        {
            isValid = true;
        }
    }
    return Json(new { isValid = isValid });
}

方案2：AJAX直接处理文件下载与错误提示 #

这种方法不用额外的校验接口，直接通过AJAX请求接收响应，根据返回内容判断是文件还是错误提示，更简洁。

具体步骤： #

1. 修改视图按钮：

<button id="download-btn">下载文件</button>
@Html.AntiForgeryToken() <!-- 必须加这个，不然AntiForgery校验会失败 -->

2. 写JS处理逻辑：

$("#download-btn").click(function() {
    var token = $('input[name="__RequestVerificationToken"]').val();
    $.ajax({
        url: '@Url.Action("DownloadFile", "Results")',
        type: 'POST',
        data: { 
            ResultID: '@Model.Result.ResultID',
            __RequestVerificationToken: token
        },
        xhrFields: {
            responseType: 'blob' // 告诉AJAX要接收二进制数据
        },
        success: function(blob, status, xhr) {
            var contentType = xhr.getResponseHeader("Content-Type");
            if (contentType === "application/json") {
                // 是错误JSON，解析后显示提示
                var reader = new FileReader();
                reader.onload = function() {
                    var res = JSON.parse(reader.result);
                    alert(res.message || "下载失败");
                };
                reader.readAsText(blob);
            } else {
                // 是文件，生成临时链接触发下载
                var filename = xhr.getResponseHeader("Content-Disposition")?.split("filename=")[1].replace(/"/g, '');
                var url = window.URL.createObjectURL(blob);
                var a = document.createElement('a');
                a.href = url;
                a.download = filename || "file.txt";
                document.body.appendChild(a);
                a.click();
                window.URL.revokeObjectURL(url);
                document.body.removeChild(a);
            }
        },
        error: function() {
            alert("下载失败");
        }
    });
});

3. 修改控制器DownloadFile方法：
   当文件无效时返回JSON提示，而不是EmptyResult：

public ActionResult DownloadFile(int ResultID)
{
    using (var stream = GetFileStream(ResultID))
    {
        if (stream == null || stream.Length == 0)
        {
            // 返回错误JSON
            return Json(new { message = "下载失败" }, JsonRequestBehavior.AllowGet);
        }
        string fullName = GetFileName(ResultID);
        // 加Content-Disposition头，方便前端获取文件名
        Response.AddHeader("Content-Disposition", $"attachment; filename=\"{fullName}.txt\"");
        return File(stream, "text/plain", $"{fullName}.txt");
    }
}

注意事项 #

• 不管用哪个方案，都要确保页面里有@Html.AntiForgeryToken()，不然POST请求会被AntiForgery拦截。
• 方案2里，控制器返回JSON时要注意JsonRequestBehavior.AllowGet，避免MVC阻止请求返回JSON。
• 获取文件流后记得用using自动释放，避免内存泄漏。

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