Java使用iTextPDF生成PDF时特殊字符(äöüß)显示异常求助

核心原因 #

硬编码的德语特殊字符显示异常，本质是源码文件编码与Java编译时使用的编码不匹配，导致字符串在程序运行时已经是错误的字节序列，后续字体配置无法修复这个前置问题。

正确解决方案 #

1. 统一源码文件编码为UTF-8

将IDE（IDEA/Eclipse等）的项目编码、文件编码均设置为UTF-8，确保硬编码的äöüß等字符被正确保存为UTF-8字节序列。

2. 使用支持Unicode的字体 + 正确编码参数

iText内置的StandardFonts.HELVETICA等字体仅支持有限的编码（如WinAnsi），不包含德语特殊字符的Unicode码位，必须使用支持全Unicode的TrueType/OpenType字体（如FreeSans、Arial Unicode MS），并指定PdfEncodings.IDENTITY_H编码（iText中支持全Unicode的水平书写编码）。

示例代码：

// 加载支持Unicode的字体文件，强制嵌入到PDF中避免设备无字体导致异常
PdfFont unicodeFont = PdfFontFactory.createFont(
    "font/FreeSans.ttf", 
    PdfEncodings.IDENTITY_H, 
    PdfFontFactory.EmbeddingStrategy.FORCE_EMBEDDED
);

PdfWriter writer = new PdfWriter("output.pdf");
PdfDocument pdf = new PdfDocument(writer);
Document document = new Document(pdf);

// 设置全局字体
document.setFont(unicodeFont);
// 添加硬编码特殊字符文本
document.add(new Paragraph("äöüß"));

document.close();

3. 确保编译时使用UTF-8编码

• Maven配置（pom.xml）：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.11.0</version>
              <configuration>
                  <encoding>UTF-8</encoding>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• Gradle配置（build.gradle）：

  tasks.withType(JavaCompile) {
      options.encoding = 'UTF-8'
  }
  

• 命令行编译：

  javac -encoding UTF-8 YourPDFGenerator.java
  

之前尝试方案的问题解析 #

1. FreeSans + UTF-8编码：iText中PdfFontFactory.createFont的第二个参数是字体的编码映射规则，而非字符串编码，UTF-8不是PDF字体的有效编码标识，导致字符无法正确映射。
2. Helvetica + UTF8：Helvetica内置字体不支持UTF-8对应的全Unicode字符，无法识别äöüß。
3. 手动转字符串：硬编码字符串已在编译时因编码不匹配损坏，后续转码无法修复原始错误。
4. CP1252 + ISO-8859-1临时方案：仅依赖编辑器与编译环境的编码巧合（两者对äöüß的字节编码一致），环境编码变更后会立即失效，属于不可靠的临时 workaround。

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