如何使用PDFBox 2.0.27将PDF标准14种字体替换为免费字体？

PDFBox本身提供了直接的字体替换机制，不需要依赖系统字体别名，你可以通过自定义FontMapper来拦截标准字体的请求，替换成你需要的免费字体（比如Linux Libertine）。

核心实现步骤 #

1. 加载目标替代字体
   先把要用来替换的字体文件加载为PDFBox可识别的PDType0Font（支持TrueType/OpenType字体），确保字体文件路径在Linux系统中可访问（比如/usr/share/fonts/truetype/linux-libertine/下的文件）。

2. 自定义FontMapper拦截字体请求
   扩展DefaultFontMapper，重写getFont方法，把PDF中使用的标准14种字体名称映射到对应的替代字体。

   示例代码：

   import org.apache.pdfbox.pdmodel.PDDocument;
   import org.apache.pdfbox.pdmodel.font.PDType0Font;
   import org.apache.pdfbox.printing.DefaultFontMapper;
   import org.apache.pdfbox.printing.FontMapper;
   import org.apache.pdfbox.printing.PDFPrintable;
   
   import java.io.File;
   import java.io.IOException;
   import java.awt.print.PrinterJob;
   
   public class PdfFontReplacementPrinter {
       public static void main(String[] args) throws IOException {
           PDDocument document = PDDocument.load(new File("target.pdf"));
   
           // 自定义字体映射器
           FontMapper customFontMapper = new DefaultFontMapper() {
               @Override
               public PDType0Font getFont(String baseFont) {
                   // 映射Times-Roman到Linux Libertine Regular
                   if ("Times-Roman".equals(baseFont)) {
                       try {
                           return PDType0Font.load(document, new File("/usr/share/fonts/truetype/linux-libertine/LinLibertine_R.ttf"));
                       } catch (IOException e) {
                           e.printStackTrace();
                           // 替换失败时回退到默认逻辑
                           return super.getFont(baseFont);
                       }
                   }
                   // 映射Times-Bold到Linux Libertine Bold
                   else if ("Times-Bold".equals(baseFont)) {
                       try {
                           return PDType0Font.load(document, new File("/usr/share/fonts/truetype/linux-libertine/LinLibertine_B.ttf"));
                       } catch (IOException e) {
                           e.printStackTrace();
                           return super.getFont(baseFont);
                       }
                   }
                   // 映射Helvetica到Liberation Sans（另一种免费无衬线字体）
                   else if ("Helvetica".equals(baseFont)) {
                       try {
                           return PDType0Font.load(document, new File("/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf"));
                       } catch (IOException e) {
                           e.printStackTrace();
                           return super.getFont(baseFont);
                       }
                   }
                   // 其他标准字体（如Courier、Symbol等）可按同样方式添加映射
                   return super.getFont(baseFont);
               }
           };
   
           // 配置打印对象并设置自定义字体映射器
           PDFPrintable printable = new PDFPrintable(document);
           printable.setFontMapper(customFontMapper);
   
           // 执行打印流程
           PrinterJob printerJob = PrinterJob.getPrinterJob();
           printerJob.setPrintable(printable);
           if (printerJob.printDialog()) {
               try {
                   printerJob.print();
               } catch (Exception e) {
                   e.printStackTrace();
               }
           }
   
           document.close();
       }
   }
   

关键注意事项 #

• 覆盖全变体：标准14种字体包含常规、粗体、斜体、粗斜体等变体（如Times-Roman、Times-Bold、Times-Italic、Times-BoldItalic），要对应替换到目标字体的对应变体，避免样式错乱。
• 字体路径验证：确保Linux系统中确实存在该字体文件，路径可以通过fc-list命令确认（比如fc-list | grep Libertine）。
• 字符集兼容性：选择的替代字体要支持PDF文档中的所有字符，避免出现方块或乱码。

为什么系统字体别名无效？ #

PDFBox处理标准14种字体时，是直接基于字体名称字符串进行匹配查找，不会读取系统的字体别名配置。因此必须通过代码层面的FontMapper拦截来实现替换，无法依赖系统层面的字体别名映射。

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