Linux环境下通过Response输出的Excel文件无法打开求助

测试现象 #

• 本地Windows环境运行正常，Linux测试环境返回的文件无法打开
• Linux环境通过curl下载的文件同样无法打开
• 不通过Response直接保存文件时正常，确认问题出在写入Response的环节
• 异常时返回的文件尺寸大于正常文件

相关代码 #

SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
String fn = fileName + sdf.format(new Date()) + ".xlsx";

String utf = "UTF-8";

response.setContentType("application/vnd.ms-excel;charset=UTF-8");
response.setCharacterEncoding(utf);
response.setHeader("Pragma", "public");
response.setHeader("Cache-Control", "max-age=30");
response.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode(fn, utf));

问题原因分析 #

1. 字符编码设置破坏二进制流：xlsx是二进制格式文件，response.setCharacterEncoding(utf)会强制把输出流当成字符流处理，对二进制数据做编码转换，直接破坏文件结构。Windows和Linux默认字符编码不同，Windows环境可能未触发该问题，Linux下则直接暴露。
2. Content-Type类型错误：application/vnd.ms-excel是旧版xls格式的MIME类型，xlsx格式需要使用application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，错误类型可能导致解析工具处理异常。
3. 输出流类型错误：如果代码中使用PrintWriter（字符输出流）写入Excel数据，同样会对二进制内容做编码转换，造成文件损坏。

解决方案 #

关键修改点：

• 移除response.setCharacterEncoding(utf)，二进制文件无需设置字符编码
• 替换为xlsx专属的Content-Type
• 必须使用**字节输出流（OutputStream）**写入Response，禁止使用字符输出流

修正后的代码示例

SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
String fn = fileName + sdf.format(new Date()) + ".xlsx";
String utf = "UTF-8";

// 设置xlsx对应的正确MIME类型
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Pragma", "public");
response.setHeader("Cache-Control", "max-age=30");
// 优化文件名编码，兼容多浏览器
response.setHeader("Content-Disposition", "attachment; filename=\"" + URLEncoder.encode(fn, utf) + "\"; filename*=UTF-8''" + URLEncoder.encode(fn, utf));

// 使用字节输出流写入Excel内容（假设workbook是你生成的Excel工作簿对象）
OutputStream out = response.getOutputStream();
workbook.write(out);
out.flush();
out.close();

验证步骤 #

1. 部署修正后的代码到Linux环境
2. 直接下载或用curl获取文件，检查文件大小是否与本地保存的一致
3. 尝试打开文件，确认能否正常解析

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