Android使用iText7处理PDF报Unknown 0.0规范不支持异常如何修复

问题现象 #

在Android平台使用iText7（7.2.3版本）处理PDF文件时，部分特定PDF触发运行时崩溃。
触发崩溃的代码逻辑：

val pdfReader = PdfReader(readerFile)
val pdfWriter = PdfWriter(writerFile)
val pdfDoc = PdfDocument(pdfReader, pdfWriter)

抛出的核心异常信息：

java.lang.UnsupportedOperationException: This parser does not support specification "Unknown" version "0.0"

完整崩溃堆栈：

E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.example.compresspdf, PID: 9272
    java.lang.UnsupportedOperationException: This parser does not support specification "Unknown" version "0.0"
        at javax.xml.parsers.DocumentBuilderFactory.setXIncludeAware(DocumentBuilderFactory.java:475)
        at com.itextpdf.kernel.utils.DefaultSafeXmlParserFactory.configureSafeDocumentBuilderFactory(DefaultSafeXmlParserFactory.java:177)
        at com.itextpdf.kernel.utils.DefaultSafeXmlParserFactory.createDocumentBuilderInstance(DefaultSafeXmlParserFactory.java:118)
        at com.itextpdf.kernel.utils.XmlProcessorCreator.createSafeDocumentBuilder(XmlProcessorCreator.java:96)
        at com.itextpdf.kernel.xmp.impl.XMPMetaParser.parseInputSource(XMPMetaParser.java:284)
        at com.itextpdf.kernel.xmp.impl.XMPMetaParser.parseXmlFromBytebuffer(XMPMetaParser.java:204)
        at com.itextpdf.kernel.xmp.impl.XMPMetaParser.parseXml(XMPMetaParser.java:147)
        at com.itextpdf.kernel.xmp.impl.XMPMetaParser.parse(XMPMetaParser.java:92)
        at com.itextpdf.kernel.xmp.XMPMetaFactory.parseFromBuffer(XMPMetaFactory.java:169)
        at com.itextpdf.kernel.xmp.XMPMetaFactory.parseFromBuffer(XMPMetaFactory.java:155)
        at com.itextpdf.kernel.pdf.XmpMetaInfoConverter.appendMetadataToInfo(XmpMetaInfoConverter.java:62)
        at com.itextpdf.kernel.pdf.PdfDocument.getDocumentInfo(PdfDocument.java:677)
        at com.itextpdf.kernel.pdf.PdfDocument.open(PdfDocument.java:2033)
        at com.itextpdf.kernel.pdf.PdfDocument.<init>(PdfDocument.java:318)
        at com.itextpdf.kernel.pdf.PdfDocument.<init>(PdfDocument.java:286)
        at com.example.compresspdf.PdfKt.editDocument(pdf.kt:46)

从堆栈可定位错误触发点：iText7核心库中DefaultSafeXmlParserFactory类调用系统DocumentBuilderFactory的setXIncludeAware方法时抛出异常。问题可在Jetpack Compose实现的PDF编辑示例项目中稳定复现。

根因分析 #

• Android系统内置的XML解析器实现存在兼容性差异，部分厂商定制版本、低系统版本的DocumentBuilderFactory未实现setXIncludeAware等接口，调用时直接抛出UnsupportedOperationException
• 触发崩溃的PDF均携带XMP元数据块，iText打开文档时会自动初始化XML解析器解析元数据，从而走到兼容性问题触发逻辑

修复方案 #

• 方案1：自定义兼容Android的XML解析工厂（优先选用）
  在App初始化阶段（如Application.onCreate）替换iText默认的XML解析工厂，捕获系统不支持的配置调用异常，降级设置基础安全属性，无需修改原有PDF处理逻辑，兼容性最好。
  实现代码：

  import com.itextpdf.kernel.utils.DefaultSafeXmlParserFactory
  import com.itextpdf.kernel.utils.XmlProcessorCreator
  import javax.xml.parsers.DocumentBuilderFactory
  import javax.xml.parsers.ParserConfigurationException
  
  class AndroidCompatXmlParserFactory : DefaultSafeXmlParserFactory() {
      @Throws(ParserConfigurationException::class)
      override fun configureSafeDocumentBuilderFactory(factory: DocumentBuilderFactory) {
          try {
              super.configureSafeDocumentBuilderFactory(factory)
          } catch (e: UnsupportedOperationException) {
              // 跳过Android平台不支持的配置项，手动设置基础XML安全属性
              factory.setFeature("http://xml.org/sax/features/external-general-entities", false)
              factory.setFeature("http://xml.org/sax/features/external-parameter-entities", false)
              factory.setFeature("http://apache.org/xml/features/nonvalidating/load-external-dtd", false)
              factory.isNamespaceAware = true
          }
      }
  }
  
  // 初始化时注册自定义工厂
  XmlProcessorCreator.setXmlParserFactory(AndroidCompatXmlParserFactory())
  

• 方案2：关闭XMP元数据严格解析
  如果业务逻辑不需要读取、修改PDF的XMP元数据，可以在初始化PdfReader时关闭严格元数据解析，直接跳过触发异常的XML解析流程：

  val readerProperties = ReaderProperties().apply {
      setXmpMetadataStrict(false)
  }
  val pdfReader = PdfReader(readerFile, readerProperties)
  val pdfWriter = PdfWriter(writerFile)
  val pdfDoc = PdfDocument(pdfReader, pdfWriter)
  

  注意：该方案会导致无法正常读取PDF内置的XMP元数据，仅适用于无元数据操作需求的场景。

• 方案3：升级iText7依赖版本
  iText 7.2.5及以上官方版本已经针对Android平台的XML解析器兼容性做了适配修复，若项目允许升级依赖，可直接将iText7核心库升级到最新稳定版解决问题。

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