Java8使用HttpServletResponse生成阿拉伯语CSV/PDF报表乱码如何解决

• 你控制台输出正常说明Java内存中阿拉伯语字符串编码本身无问题，乱码是导出后文件的解码环节不匹配导致的
• CSV乱码核心原因：微软Excel等常用表格工具默认不会把无BOM的UTF-8文件识别为UTF-8编码，会用系统默认编码（如Windows的Latin1/GBK）解码，多字节的阿拉伯语字符就会被解析为你看到的Ø/Ù类乱码
• PDF乱码核心原因：默认PDF生成库用的内置字体不支持阿拉伯语字形，且未开启从右到左（RTL）的排版适配

你需要在输出UTF-8编码的CSV内容前，先写入UTF-8 BOM头（3个固定字节0xEF 0xBB 0xBF），同时对导出文件名做编码兼容，修改后代码如下：

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import javax.servlet.ServletOutputStream;

// 先构造字符串，确保字符串本身内容正确（你控制台正常这步没问题）
String content = str.toString();
// 获取response对象
HttpServletResponse response = (HttpServletResponse) FacesContext.getCurrentInstance().getExternalContext().getResponse();
// 先设置响应头和编码
response.setCharacterEncoding("UTF-8");
response.setContentType("application/csv; charset=UTF-8");
// 文件名编码，避免非ASCII文件名乱码
String encodedFileName = URLEncoder.encode(exportFileName, "UTF-8").replaceAll("\\+", "%20");
response.addHeader("Content-Disposition", "attachment; filename=" + encodedFileName + ".csv");

// 输出字节流
ServletOutputStream out = response.getOutputStream();
// 先写UTF-8 BOM头，适配Excel解码逻辑
out.write(new byte[]{(byte) 0xEF, (byte) 0xBB, (byte) 0xBF});
// 再写CSV内容字节
byte[] csvContent = content.getBytes(StandardCharsets.UTF_8);
response.setContentLength(csvContent.length + 3); // 加上BOM的3字节长度
out.write(csvContent);
out.flush();
FacesContext.getCurrentInstance().responseComplete();

小提示：如果是给不支持BOM的工具导出CSV，可以去掉BOM头，打开文件时手动指定编码为UTF-8即可。

如果是用iText、Apache PDFBox这类工具生成PDF，需要做两个配置：

• 嵌入支持阿拉伯语的字体：不要用PDF内置的核心字体，改为嵌入Arial Unicode MS、Noto Naskh Arabic等包含阿拉伯语字形的字体
• 开启RTL排版适配：阿拉伯语是从右到左书写的语言，需要配置排版方向为从右到左，比如iText中设置setRunDirection(PdfWriter.RUN_DIRECTION_RTL)即可

内容的提问来源于stack exchange，提问作者kaouther ben smida