Struts 1应用CSV导出编码异常问题排查求助

核心问题定位 #

你代码里的out.write(csv.getBytes());是关键隐患：String.getBytes()会使用当前JVM的系统默认字符集，这就是Windows和Linux环境差异的来源：

• Windows环境默认字符集通常是ISO-8859-1（或Windows-1252），和你本地导出的编码匹配，所以带重音的特殊字符显示正常。
• Linux环境默认字符集为UTF-8，但CSV以UTF-8导出后，部分工具（比如Excel）会默认用系统编码解析，导致乱码。

具体解决步骤 #

1. 强制指定导出编码 #

直接在getBytes()里指定明确编码，推荐使用UTF-8并添加BOM（解决Excel识别UTF-8 CSV乱码的问题）：

// 写入UTF-8 BOM，让Excel正确识别编码
out.write(new byte[]{(byte)0xEF, (byte)0xBB, (byte)0xBF});
// 用UTF-8编码转换字符串
out.write(csv.getBytes(StandardCharsets.UTF_8));

如果要和本地保持一致使用ISO-8859-1，替换为：

out.write(csv.getBytes(StandardCharsets.ISO_8859_1));

注意：需要导入java.nio.charset.StandardCharsets（Java 7及以上版本支持）。

2. 响应头补充编码声明 #

在response中明确设置Content-Type的编码，告诉下载工具文件的正确编码：

response.setContentType("text/csv; charset=UTF-8");
// 若使用ISO-8859-1则改为：
// response.setContentType("text/csv; charset=ISO-8859-1");

3. 修复文件名编码问题（可选） #

如果文件名包含特殊字符，不同系统可能出现解析异常，建议遵循RFC 5987标准编码文件名：

String encodedFilename = URLEncoder.encode(filename, StandardCharsets.UTF_8.toString());
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + encodedFilename);

排查验证点 #

• 检查Linux服务器的JVM默认编码：执行java -Dfile.encoding命令，确认是否为UTF-8。若需强制JVM使用指定编码，可在WebLogic启动参数中添加-Dfile.encoding=ISO-8859-1（不推荐，可能影响其他应用模块）。
• 用专业文本编辑器（如Notepad++）打开服务器导出的CSV，查看实际编码和内容，对比本地文件的差异。
• 确认数据库中存储的特殊字符编码是否正确：若数据库采用UTF-8存储，使用UTF-8+BOM导出是更规范的长期解决方案。

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