使用PDFBox/iTextPdf读取PDF表单字段为空的问题排查

• 检查是否是XFA表单：不少可填充PDF用的是XFA（XML表单架构）而非标准AcroForm，PDFBox默认不会解析这类字段。可以用代码判断：

  val acroForm = docCatalog.getAcroForm()
  if (acroForm != null && acroForm.hasXFA()) {
      val xfaDocument = acroForm.getXFA()
      // 需要解析XFA对应的XML内容来获取字段
      println("该PDF使用XFA表单，需处理XML结构")
  }
  

• 改用getAllFields()获取字段：getFields()只返回顶层字段，嵌套在字段组里的子字段不会被返回，换成getAllFields()能拿到所有层级的表单字段：

  println("所有字段:" + acroForm.getAllFields())
  

• 确认PDF未被扁平化：如果PDF被导出为“仅保留表单外观”（扁平化处理），实际的可编辑字段会被移除，只剩静态文本，这种情况只能重新获取原始可编辑PDF。

• 升级PDFBox版本：旧版本对新型AcroForm支持不足，建议用最新稳定版（如2.0.x系列），若要处理XFA，还需引入PDFBox的XFA扩展依赖。

• 先判断AcroForm是否为空：先检查acroForm是否为null，避免空指针的同时确认文档是否真的包含AcroForm：

  val acroForm = docCatalog.getAcroForm()
  if (acroForm == null) {
      println("文档中未找到AcroForm表单结构")
  } else {
      println("所有字段:" + acroForm.getAllFields())
  }
  

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