Apache PDFBox如何添加多种字体？解决字形缺失报错问题

当然支持！Apache PDFBox完全可以实现类似iText的多字体回退逻辑，来处理包含不同字符集的文本，解决你遇到的「No glyph for U+XXXX」这类字形缺失问题。它只是没有像iText那样封装好的FontSelector类，需要我们自己实现字符与字体的匹配逻辑，其实并不复杂。

核心实现思路 #

我们的目标是：对于文本中的每个字符，找到第一个能渲染它的字体，然后分段用对应字体绘制文本。下面是具体的步骤和代码示例：

1. 加载所需的多字体文件 #

首先把需要的字体（比如覆盖主流字符的Noto Sans，以及针对特定语言的补充字体）加载为PDFBox的PDFont对象：

// 加载主字体（例如Noto Sans，支持大部分常见语言）
PDFont mainFont = PDType0Font.load(document, new File("NotoSans-Regular.ttf"));
// 加载补充字体（例如针对阿拉伯语的Noto Sans Arabic，处理主字体覆盖不到的字符）
PDFont arabicFallback = PDType0Font.load(document, new File("NotoSansArabic-Regular.ttf"));
// 可以继续添加更多补充字体，比如中文、日文等

2. 编写字符渲染检查工具方法 #

我们需要一个方法来判断某个字体是否能渲染指定字符，针对不同类型的字体（比如PDType0Font这类支持CID的现代字体）做适配：

private static boolean canRenderChar(PDFont font, char targetChar) throws IOException {
    if (font instanceof PDType0Font) {
        // 对于PDType0字体，检查CID集合是否包含该字符的编码
        PDType0Font type0Font = (PDType0Font) font;
        return type0Font.getDescendantFont().getCIDSet().contains((int) targetChar);
    } else {
        // 对于其他字体类型，检查编码是否包含该字符
        return font.getEncoding().contains(targetChar);
    }
}

3. 分段匹配字体并绘制文本 #

遍历文本中的每个字符，找到合适的字体，然后连续绘制同一字体能覆盖的子串：

PDPageContentStream contentStream = new PDPageContentStream(document, page);
contentStream.beginText();
contentStream.setFont(mainFont, 12); // 先设置默认主字体
contentStream.newLineAtOffset(50, 700); // 设置文本起始位置

String mixedText = "包含多语言的测试文本：سلام 你好 Hello";
int currentIndex = 0;

while (currentIndex < mixedText.length()) {
    char currentChar = mixedText.charAt(currentIndex);
    PDFont selectedFont = null;

    // 遍历字体列表，找到第一个能渲染当前字符的字体
    if (canRenderChar(mainFont, currentChar)) {
        selectedFont = mainFont;
    } else if (canRenderChar(arabicFallback, currentChar)) {
        selectedFont = arabicFallback;
    }
    // 可以继续添加更多字体的判断逻辑

    // 找到当前字体能连续渲染的最长子串
    int endIndex = currentIndex;
    while (endIndex < mixedText.length() && canRenderChar(selectedFont, mixedText.charAt(endIndex))) {
        endIndex++;
    }
    String subText = mixedText.substring(currentIndex, endIndex);

    // 如果字体切换了，重新设置当前字体
    if (!selectedFont.equals(contentStream.getCurrentFont())) {
        contentStream.setFont(selectedFont, 12);
    }

    // 绘制子串
    contentStream.showText(subText);
    currentIndex = endIndex;
}

contentStream.endText();
contentStream.close();

额外提示 #

• 如果需要支持更多语言，只需要扩展字体列表，在判断逻辑中依次检查即可。
• 建议使用PDFBox 2.x及以上的版本，对现代字体的支持更完善，能减少很多兼容性问题。
• 对于复杂排版需求（比如自动换行、对齐），可以把字体选择逻辑封装成一个工具类，让代码更易维护。

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