You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用iText 8.0.4将HTML转PDFUA时出现字体未嵌入异常的原因

异常原因分析
  • PDF/UA标准的强制约束:PdfUADocument是iText中用于生成符合**PDF/UA(通用无障碍)**标准文档的类,该标准为保障辅助技术(如屏幕阅读器)能正确解析文本,强制要求所有文档中使用的字体必须嵌入到PDF文件内部。而普通的PdfDocument没有无障碍合规性要求,允许依赖阅读器自带的系统字体,因此不会触发该异常。

  • 标准14字体的处理差异:Times-Roman属于PDF标准14字体,在普通PDF生成场景下,iText默认不会嵌入这类字体(因为绝大多数PDF阅读器都预装了这些字体)。但PDF/UA标准不接受这种“依赖外部字体”的做法,必须将字体文件嵌入到PDF中,否则就会抛出PDFUAConformanceException提示字体未嵌入。

  • HTML转换的字体回退逻辑:当你从HTML转换为PDF时,如果HTML代码中没有指定明确的可嵌入字体,iText会默认回退使用Times-Roman这类标准字体。在PdfDocument模式下这种回退是允许的,但PdfUADocument模式下,由于合规要求,必须确保该字体的嵌入逻辑已配置,而你的环境中未完成这一配置,因此触发了异常。

内容的提问来源于stack exchange,提问作者Lucky

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.22 09:42:36