使用iTextPDF 8.0.3生成支持Emoji的PDF显示异常求助

云上老周

2026-6-22

解决iTextPDF 8.0.3中Emoji显示为占位符的问题

可能的原因及解决思路

1. 确认字体文件的有效性与路径

检查seguiemj.ttf是否在项目可访问路径内：用绝对路径测试，或把字体放入resources目录通过类加载器读取，确保路径无误。
验证字体是否包含目标Emoji（U+1F600）：用FontForge等工具打开字体，确认该字符存在。seguiemj.ttf作为Windows系统字体，部分版本对新Emoji支持有限，建议替换为Noto Color Emoji这类完整支持彩色Emoji的开源字体。

2. 正确加载彩色字体

iText 8处理彩色Emoji需确保启用彩色渲染模式，加载Noto Color Emoji的示例代码：

PdfFont emojiFont = PdfFontFactory.createFont(
    "NotoColorEmoji.ttf", 
    PdfEncodings.IDENTITY_H,
    PdfFontFactory.EmbeddingStrategy.FORCE_EMBEDDED
);

3. 简化段落结构，避免样式冲突

原代码将文本和Emoji拆分为两个Paragraph可能导致渲染异常，建议合并为单个段落：

Paragraph paragraph = new Paragraph("Hello \uD83D\uDE00")
        .setFont(emojiFont)
        .setFontSize(20)
        .setFontColor(new DeviceRgb(243, 58, 106));

4. 优化字符编码处理

Java 11+可直接用\u{1F600}替代UTF-16代理对\uD83D\uDE00，避免解析问题：

Paragraph paragraph = new Paragraph("Hello \u{1F600}")
        .setFont(emojiFont)
        .setFontSize(20)
        .setFontColor(new DeviceRgb(243, 58, 106));