解决JasperReport 6+ PDF中文不显示问题：字体配置详解

"本文档提供了解决jasperreport6版本以上导出PDF时中文不显示问题的方法。由于jasperreport6以上版本不再使用旧的pdf font name和pdf encoding配置，而是采用新的font配置来处理字体，因此传统的通过iText jar包解决PDF中文显示问题的方式已不再适用。文档给出了具体的解决方案，即修改jasperreports的字体文件，通过更新fonts.xml文件并正确配置，可以一次性解决此问题。" 在jasperreport6中，当尝试导出包含中文的PDF报告时，可能会遇到中文字符无法正常显示的问题。这主要是由于新版本中对字体处理方式的改变。为了解决这个问题，我们需要按照以下步骤操作： 1. 首先，你需要下载jasperreports-6.1.1-project.zip文件，并解压到指定目录，例如：D:\jasperreports-6.1.1-project。 2. 在解压后的文件夹中，找到`demo\fonts`目录下的`net\sf\jasperreports\fonts\dejavu`文件夹。这个路径下通常包含了默认的字体文件。这里，我们使用`simsun.ttf`（宋体）作为中文支持的字体，它通常存在于Windows系统的`windows\fonts`目录中，你需要将它复制到jasperreports的字体目录。 3. 接下来，你需要编辑`demo\fonts\net\sf\jasperreports\fonts`目录下的`fonts.xml`文件。在这个文件中，你需要创建一个名为“”的`<fontFamily>`元素。在该元素内，为各种字体样式（正常、粗体、斜体、粗斜体）指定`simsun.ttf`的路径，并设置`pdfEncoding`为`Identity-H`，表示使用Unicode编码，并将`pdfEmbedded`属性设置为`true`，以确保字体嵌入到PDF中。 示例配置如下： ```xml <fontFamily name=""> <normal>net/sf/jasperreports/fonts/dejavu/simsun.ttf</normal> <bold>net/sf/jasperreports/fonts/dejavu/simsun.ttf</bold> <italic>net/sf/jasperreports/fonts/dejavu/simsun.ttf</italic> <boldItalic>net/sf/jasperreports/fonts/dejavu/simsun.ttf</boldItalic> <pdfEncoding>Identity-H</pdfEncoding> <pdfEmbedded>true</pdfEmbedded> <exportFonts> <export key="net.sf.jasperreports.html">'',Arial,Helvetica,sans-serif</export> <export key="net.sf.jasperreports.xhtml">'',Arial,Helvetica,sans-serif</export> </exportFonts> </fontFamily> ``` 4. 保存并关闭`fonts.xml`文件后，回到`demo\fonts`目录，执行`mvn package`命令，这将打包所有必要的资源，并使得新的字体配置生效。 5. 最后，你可以使用更新后的jasperreports库来生成PDF报告，此时中文应该能够正常显示了。 通过以上步骤，jasperreport6的PDF导出功能将能够正确地处理和显示中文字符，避免了因字体配置问题导致的显示异常。这种方法不仅适用于jasperreport6.1.1版本，对于其他6.x版本也应具有参考价值。在实际应用中，根据你的系统环境和需求，可能需要选择不同的字体文件和进行相应的配置调整。