Java Web服务导出Excel：HttpServletResponse参数不生效问题

我之前踩过一模一样的坑！你遇到的问题本质是HTTP响应头里的文件名编码在不同浏览器里有兼容性差异，加上处理不当导致文件名被截断成“t...”。结合你提到问题已修复，我来拆解下正确的处理逻辑和代码：

问题到底出在哪？ #

• 直接写response.setHeader("Content-Disposition", "attachment; filename=xxx.xlsx")根本扛不住特殊字符（á、ó、ñ这类）和带日期的长文件名——不同浏览器对编码的解析规则不一样，要么乱码要么直接截断。
• 比如Chrome/Firefox支持UTF-8编码的文件名，但得用标准的filename*=UTF-8''格式；IE老版本则需要用URL编码，两种格式混着来才不会出问题。

修复后的完整代码示例 #

下面是我自己在用的兼容多浏览器的实现，你可以参考：

import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.time.LocalDate;
import javax.servlet.http.HttpServletResponse;

public void exportExcel(HttpServletResponse response) throws IOException {
    // 生成带日期和特殊字符的原始文件名
    String originalFileName = "数据导出_" + LocalDate.now() + "_áóñ.xlsx";
    
    // 对文件名进行UTF-8编码，注意把+替换成%20（URL编码里空格会转成+，但HTTP头里需要%20）
    String encodedFileName = URLEncoder.encode(originalFileName, "UTF-8").replaceAll("\\+", "%20");
    
    // 构建兼容新旧浏览器的Content-Disposition头
    // 同时设置filename和filename*，现代浏览器优先解析filename*，旧浏览器用filename兜底
    String contentDisposition = String.format("attachment; filename=\"%s\"; filename*=UTF-8''%s", 
            originalFileName, encodedFileName);
    
    // 核心响应头设置
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); // Excel 2007+的MIME类型
    response.setCharacterEncoding("UTF-8");
    response.setHeader("Content-Disposition", contentDisposition);
    
    // 这里写你的Excel生成逻辑，比如用Apache POI写入输出流
    try (OutputStream out = response.getOutputStream()) {
        // 示例：假设你已经用POI创建好了Workbook对象
        // workbook.write(out);
    }
}

关键细节要注意 #

• 双文件名格式：filename="xxx"是给旧浏览器兜底的，filename*=UTF-8''xxx是RFC 5987标准的UTF-8编码格式，现代浏览器会优先用这个，完美支持á、ó、ñ这类特殊字符。
• 编码替换：一定要把URLEncoder生成的+换成%20，不然文件名里的空格会变成加号，看着很奇怪。
• 正确的MIME类型：如果是导出.xlsx格式，必须用application/vnd.openxmlformats-officedocument.spreadsheetml.sheet；如果是.xls旧格式，用application/vnd.ms-excel，不然浏览器可能识别错误，导致下载异常。

为啥之前只显示“t...”？ #

大概率是因为你之前的文件名没有编码，浏览器解析时遇到特殊字符或者过长的内容，直接把文件名截断了——比如未编码的特殊字符被浏览器当成了分隔符，只显示到第一个异常字符前的内容，就出现了“t...”这种情况。

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