Spring MVC中点击文件名无法触发下载弹窗的问题排查

你遇到的核心问题是用AJAX发起文件下载请求——AJAX的设计初衷是在后台异步获取数据，它不会触发浏览器的文件下载对话框，哪怕后端返回了正确的下载响应头也没用，因为浏览器不会将AJAX的响应视为“需要下载的文件”来处理。

具体问题分析 #

1. 前端AJAX的局限性：你的$.ajax请求会成功获取到文件流，但浏览器只会把这个流当作AJAX响应数据，不会自动弹出下载窗口。
2. 后端的小bug：你的Content-Disposition头里的filename参数传入的是downloadFile对象，而不是文件名。这会导致文件名变成类似[File@xxxx]的字符串，虽然这不是当前不弹出下载框的主要原因，但也是需要修复的问题。

解决方案 #

方案1：直接跳转（最简单推荐）

放弃AJAX，直接通过页面跳转或者a标签触发下载请求，这是最直接的方式：

修改你的download函数：

function download(filename) {
    // 直接通过location.href触发下载，encodeURIComponent避免文件名含特殊字符的问题
    window.location.href = "/Putty/downloadProcess/?param=" + encodeURIComponent(filename);
}

或者用临时a标签的方式（更灵活，不会改变当前页面状态）：

function download(filename) {
    const downloadLink = document.createElement('a');
    downloadLink.href = "/Putty/downloadProcess/?param=" + encodeURIComponent(filename);
    // 可选：指定文件名，后端的Content-Disposition会优先生效
    downloadLink.download = filename;
    document.body.appendChild(downloadLink);
    downloadLink.click();
    document.body.removeChild(downloadLink);
}

方案2：如果必须用AJAX（比如需要前置验证）

如果你的业务逻辑需要先通过AJAX做一些验证，再触发下载，可以将后端返回的文件流转换成Blob，然后创建临时URL来触发下载：

function download(filename) {
    $.ajax({
        type: 'GET',
        url: "/Putty/downloadProcess/?param=" + encodeURIComponent(filename),
        xhrFields: {
            responseType: 'blob' // 告诉浏览器响应是二进制文件流
        },
        success: function(blob) {
            const downloadUrl = window.URL.createObjectURL(blob);
            const a = document.createElement('a');
            a.href = downloadUrl;
            a.download = filename;
            document.body.appendChild(a);
            a.click();
            // 清理临时资源
            window.URL.revokeObjectURL(downloadUrl);
            document.body.removeChild(a);
        }
    });
}

后端代码修复 #

别忘了修复Content-Disposition的文件名问题，把：

String headerValue = String.format("attachment; filename=\"%s\"", downloadFile);

改成：

String headerValue = String.format("attachment; filename=\"%s\"", downloadFile.getName());

这样才能正确传递文件名给浏览器。

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