Jasper Reports导出PDF图表乱码，CentOS 7等环境下求助排查

结合你提到的CentOS 7、Icinga2 2.7.5、MariaDB 5.5.56、Icinga Reports 1.10.0环境，我来梳理下这个PDF图表乱码问题的排查思路，咱们一步步来：

1. 优先排查字体缺失问题（PDF乱码最常见原因） #

PDF导出乱码90%以上都和字体未正确嵌入或系统缺失对应字体有关，尤其是带图表的场景：

• 先检查系统是否安装了常用目标语言字体（假设你是中文乱码，其他语言同理），执行命令：

  yum list installed | grep font
  

  看看有没有类似wqy-microhei-fonts、simhei-fonts这类字体包；如果没有，先安装：

  yum install wqy-microhei-fonts -y
  

• 把安装好的字体复制到Jasper Reports能识别的目录，比如Tomcat部署的Icinga Reports应用目录下：

  cp /usr/share/fonts/wqy-microhei/wqy-microhei.ttc /usr/share/tomcat/webapps/icinga-reports/WEB-INF/classes/fonts/
  

  （如果fonts目录不存在就先创建）
• 检查Icinga Reports使用的Jasper模板，确认模板里图表元素指定的字体名称和你安装的字体一致，比如模板里是否用了WenQuanYi Micro Hei或者对应字体的英文名。

2. 找到正确的排查日志文件 #

既然catalina.out没发现错误，咱们换几个日志源试试：

• 查看Icinga Reports专属日志：一般在/var/log/icinga-reports/目录下，找jasperreports.log或icinga-reports.log，这里会记录报表生成、PDF导出的细节，很可能有字体加载失败的报错
• 查看Tomcat的localhost日志：比如/var/log/tomcat/localhost.log，这里会记录Web应用的请求级错误，包括Jasper报表生成时的异常
• 查看系统全局日志：/var/log/messages，偶尔会有字体相关的系统级报错

3. 验证Jasper Reports的PDF导出配置 #

• 找到Icinga Reports的jasperreports.properties配置文件（通常在/usr/share/tomcat/webapps/icinga-reports/WEB-INF/classes/下），检查以下配置项：

  net.sf.jasperreports.default.font.name=WenQuanYi Micro Hei
  net.sf.jasperreports.default.pdf.font.name=WenQuanYi Micro Hei
  net.sf.jasperreports.default.pdf.encoding=UTF-8
  

  确保这些字体名称是系统已安装的，编码设置正确
• 检查Icinga Reports的全局配置文件（/etc/icinga-reports/icinga-reports.conf），看有没有关于PDF导出的特殊配置，比如是否禁用了字体嵌入

4. 排查图表渲染环节的字体问题 #

有时候图表乱码不是PDF导出的问题，而是Jasper依赖的图表库（比如JFreeChart）渲染时用了错误字体：

• 检查JFreeChart的默认字体设置，是否在Icinga Reports的代码或配置里指定了正确的字体，比如是否通过ChartFactory.setChartTheme设置了包含正确字体的主题
• 可以尝试生成一个不带图表的纯文本PDF报表，如果纯文本正常，那问题肯定出在图表渲染的字体配置上

5. 交叉验证导出格式 #

• 先把报表导出成HTML或Excel格式，如果这两种格式里图表显示正常，说明问题仅出在PDF导出的字体嵌入环节；如果HTML/Excel也乱码，那就是报表生成时的全局字体配置有问题

内容的提问来源于stack exchange，提问作者mr.zog