下载文件时动态设置文件名失效，实际获取UUID命名文件求助

嘿，我之前碰到过一模一样的问题，这大概率是Content-Disposition头的设置不规范，或者数据源取错了值，给你几个排查和修复的方向：

1. 先确认数据源是否正确 #

首先你得加个日志或者debug一下existingDocuments.getFileName()的返回值——会不会这个方法实际返回的就是那个UUID字符串？比如很多系统会把文件在服务器上用UUID命名存储，然后把原始文件名存在数据库里，这时候你可能误取了服务器存储的文件名，而不是用户上传的"Sample.docx"。如果是这个情况，得调整代码去拿数据库里保存的原始文件名。

2. 规范Content-Disposition头的格式 #

你的代码里直接拼接了filename，但按照HTTP规范，文件名应该用双引号包裹；而且为了兼容所有浏览器（尤其是处理特殊字符或者非ASCII文件名时），最好同时添加UTF-8编码的filename*参数，这是更标准的写法。

修正后的代码示例：

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// ... 你的其他业务代码
if (Files.exists(file)) {
    response.setContentType(existingDocuments.getContentType());
    
    // 先验证要设置的文件名是否正确
    String targetFileName = existingDocuments.getFileName();
    // 可以加日志确认：System.out.println("待设置的文件名：" + targetFileName);
    
    // 构建符合HTTP规范的Content-Disposition头
    String contentDisposition = String.format(
        "attachment; filename=\"%s\"; filename*=UTF-8''%s",
        targetFileName,
        URLEncoder.encode(targetFileName, StandardCharsets.UTF_8)
    );
    response.addHeader("Content-Disposition", contentDisposition);
    
    Files.copy(file, response.getOutputStream());
    response.getOutputStream().flush();
}

3. 排查代理或服务器配置问题 #

如果上面两步都没问题，那可能是你的反向代理（比如Nginx）或者应用服务器（比如Tomcat）的配置重写了Content-Disposition头。比如有些代理会自动修改响应头，这时候你需要检查代理的配置，确保它不会篡改这个头信息。

按照这个思路排查，应该就能解决文件名显示错误的问题啦！

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