Java poi输出pdf乱码

Java POI 输出 PDF 乱码解决方案

作为一名经验丰富的开发者，我经常被问到关于 Java POI 库在输出 PDF 时出现乱码的问题。这里，我将向刚入行的小白们介绍如何解决这个问题。

问题概述

在使用 Apache POI 库生成 PDF 文档时，如果遇到中文乱码问题，通常是因为字符编码不正确导致的。Apache POI 使用的是 ISO-8859-1 编码，而中文字符需要使用 UTF-8 编码。

解决流程

下面是解决这个问题的步骤流程图：

flowchart TD
    A[开始] --> B{检查字符编码}
    B -- 是UTF-8? --> C[使用 Apache POI 直接生成 PDF]
    B -- 不是UTF-8? --> D[转换为 UTF-8 编码]
    D --> E[使用 Apache POI 生成 PDF]
    E --> F[检查是否乱码]
    F -- 是 --> G[调整字体设置]
    F -- 不是 --> H[结束]

详细步骤

1. 检查字符编码：首先，确保你的字符串是 UTF-8 编码。如果不是，需要进行转换。

2. 转换为 UTF-8 编码（如果需要）：

   String originalText = "这是一段中文文本";
   String utf8Text = new String(originalText.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8);
   

3. 使用 Apache POI 生成 PDF：

   HWPFDocument document = new HWPFDocument();
   Range range = document.getRange();
   range.text(utf8Text);
   
   // 设置字体为支持中文的字体，如 "宋体"
   CharacterRun characterRun = range.getCharacterRun(0);
   characterRun.setFontName("宋体");
   
   // 输出 PDF
   try (FileOutputStream out = new FileOutputStream("output.pdf")) {
       PDFDocument documentPDF = new PDFDocument();
       document.write(documentPDF);
       documentPDF.write(out);
   }
   

4. 检查是否乱码：生成 PDF 后，打开查看是否还有乱码。

5. 调整字体设置（如果还有乱码）：可能需要调整字体设置，确保使用的字体支持中文。

旅行图

下面是使用 Apache POI 生成 PDF 的旅行图：

journey
    title 解决 Java POI 输出 PDF 乱码
    section 开始
      step 开始: 确定需要生成 PDF 的文本
    section 检查字符编码
      step 检查: 检查文本编码是否为 UTF-8
      step 转换: 如果不是 UTF-8，转换为 UTF-8 编码
    section 使用 Apache POI 生成 PDF
      step 创建文档: 创建 HWPFDocument 对象
      step 添加文本: 向文档添加文本
      step 设置字体: 设置支持中文的字体
      step 输出 PDF: 将文档写入 PDF 文件
    section 结束
      step 检查乱码: 打开 PDF 文件检查是否还有乱码
      step 调整字体: 如果有乱码，调整字体设置
      step 完成: 完成 PDF 生成

结尾

通过以上步骤，你应该能够解决 Java POI 输出 PDF 时的乱码问题。记住，关键在于确保字符编码正确，并使用支持中文的字体。希望这篇文章能帮助你顺利解决问题。如果还有其他问题，欢迎随时咨询。