使用FOP生成PDF时随机出现font without font-triplet异常求助

问题描述 #

使用FOP生成PDF时出现随机异常，报错信息为org.apache.fop.apps.FOPException: font without font-triplet，多数场景下PDF可正常生成，且报错未明确指向具体异常字体。完整堆栈信息如下：

org.apache.fop.apps.FOPException: font without font-triplet
    at org.apache.fop.util.LogUtil.handleError(LogUtil.java:42)
    at org.apache.fop.fonts.DefaultFontConfig$ParserHelper.parseFonts(DefaultFontConfig.java:146)
    at org.apache.fop.fonts.DefaultFontConfig$ParserHelper.parse(DefaultFontConfig.java:113)
    at org.apache.fop.fonts.DefaultFontConfig$ParserHelper.<init>(DefaultFontConfig.java:108)
    at org.apache.fop.fonts.DefaultFontConfig$ParserHelper.<init>(DefaultFontConfig.java:84)
    at org.apache.fop.fonts.DefaultFontConfig$DefaultFontConfigParser.parse(DefaultFontConfig.java:74)
    at org.apache.fop.render.pdf.PDFRendererConfig$ParserHelper.<init>(PDFRendererConfig.java:126)
    at org.apache.fop.render.pdf.PDFRendererConfig$ParserHelper.<init>(PDFRendererConfig.java:109)
    at org.apache.fop.render.pdf.PDFRendererConfig$PDFRendererConfigParser.build(PDFRendererConfig.java:101)
    at org.apache.fop.render.pdf.PDFRendererConfig$PDFRendererConfigParser.build(PDFRendererConfig.java:97)
    at org.apache.fop.apps.FopFactory.getRendererConfig(FopFactory.java:310)
    at org.apache.fop.apps.FOUserAgent.getRendererConfig(FOUserAgent.java:663)
    at org.apache.fop.render.PrintRendererConfigurator.getRendererConfig(PrintRendererConfigurator.java:91)
    at org.apache.fop.render.PrintRendererConfigurator.getRendererConfig(PrintRendererConfigurator.java:80)
    at org.apache.fop.render.pdf.PDFRendererConfigurator.configure(PDFRendererConfigurator.java:45)
Wrapped by: org.apache.fop.apps.FOPException: font without font-triplet
    at org.apache.fop.apps.FopFactory.getRendererConfig(FopFactory.java:313)
    at org.apache.fop.apps.FOUserAgent.getRendererConfig(FOUserAgent.java:663)
    at org.apache.fop.render.PrintRendererConfigurator.getRendererConfig(PrintRendererConfigurator.java:91)
    at org.apache.fop.render.PrintRendererConfigurator.getRendererConfig(PrintRendererConfigurator.java:80)
    at org.apache.fop.render.pdf.PDFRendererConfigurator.configure(PDFRendererConfigurator.java:45)
    at org.apache.fop.render.RendererFactory.createDocumentHandler(RendererFactory.java:397)
    at org.apache.fop.render.RendererFactory.tryIFDocumentHandlerMaker(RendererFactory.java:297)

已配置的字体三元组示例：

<font embed-url="classpath:/fop/static/fonts/arial.ttf">
  <font-triplet style="normal" name="Arial" weight="normal"/>
</font>
<font embed-url="classpath:/fop/static/fonts/arialbd.ttf">
  <font-triplet style="normal" name="Arial" weight="bold"/>
</font>
.........

排查与解决方法 #

• 确保FopFactory单例化
  多线程环境下重复创建FopFactory实例，会引发字体配置解析的竞态条件，导致部分字体三元组未被正确加载。全局复用同一个FopFactory实例，避免重复初始化操作。

• 验证字体资源的稳定性
  随机异常可能源于字体文件的偶尔读取失败（如类路径资源并发加载冲突、临时权限问题）。检查字体文件完整性，在应用启动阶段提前预加载字体资源，确认Jar包内字体路径配置无误，避免运行时动态加载异常。

• 补全字体三元组覆盖范围
  部分字体包含多种变体，单一三元组可能无法覆盖所有场景。为每个字体添加多组<font-triplet>，覆盖不同style和weight组合，同时确保所有<font>标签均包含至少一个三元组配置，排查是否存在遗漏项。示例：

  <font embed-url="classpath:/fop/static/fonts/arial.ttf">
    <font-triplet style="normal" name="Arial" weight="normal"/>
    <font-triplet style="italic" name="Arial" weight="normal"/>
  </font>
  

• 开启DEBUG日志定位异常字体
  将FOP字体模块的日志级别调整为DEBUG，日志会记录每个字体的解析细节。对比正常与异常场景的日志，可定位未被正确解析的字体。示例日志配置：

  <Logger name="org.apache.fop.fonts" level="DEBUG"/>
  

• 升级FOP版本修复BUG
  部分旧版FOP存在字体解析的并发BUG，升级到最新稳定版（如2.8及以上），可修复配置解析阶段的竞态问题。

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