使用Java iText 8.0.4转HTML为PDF时遇PDFUAConformanceException异常

异常原因 #

你在PdfUAConfig中设置的语言是文档级配置，但HTML转PDF过程中，iText的HtmlConverter不会自动将该配置同步到文档结构验证逻辑中；或者你的HTML内容本身缺少明确的语言标识，导致PDF/UA合规性检查无法检测到有效语言条目，触发了该异常。

解决方法 #

• 给HTML内容添加根元素语言属性
  确保HTML的根<html>标签带有lang="en-US"属性，这是PDF/UA合规的基础要求，内容层面的语言标识会被iText识别并纳入合规检查：

  <html lang="en-US">
    <!-- 你的HTML内容 -->
  </html>
  

• 转换HTML时通过ConverterProperties指定语言
  仅设置PdfUAConfig不足以覆盖转换流程的语言配置，需要在调用HtmlConverter时，通过ConverterProperties明确传递语言信息：

  // 初始化PDF/UA文档
  PdfDocument pdfDoc = new PdfUADocument(new PdfWriter(dest),
          new PdfUAConfig(PdfUAConformanceLevel.PDFUA_1, "PDF", "en-US"));
  Document doc = new Document(pdfDoc);
  
  // 配置转换属性，明确设置语言
  ConverterProperties converterProperties = new ConverterProperties();
  converterProperties.setLanguage("en-US");
  // 可根据需求添加其他配置，比如基础路径
  // converterProperties.setBaseUri("./");
  
  // 执行HTML转PDF
  HtmlConverter.convertToDocument(new FileInputStream(htmlSource), doc, converterProperties);
  
  // 关闭文档
  doc.close();
  

• 验证最终PDF的语言设置
  转换完成后，可通过PDF阅读器的文档属性查看语言是否正确设置，确保文档级和内容级的语言标识一致，满足PDF/UA合规要求。

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