iText填充PDF字段兼容问题：适配Android 6等环境的版本选型

问题核心 #

使用iText填充由MS Word生成、Adobe Acrobat 7添加文本字段的PDF时，7.1.9/7.1.15版本在执行PdfAcroForm.getAcroForm或pdfFormField.setValue操作时会异常跳转到finally块；尝试7.2.1版本时因Android 6兼容性报错，需明确适配的iText版本及组件兼容要求。

适配版本推荐 #

• 优先选择iText7-core 7.1.16~7.2.0区间的版本：
  • 7.1.16及以上修复了7.1.15及更早版本中AcroForm操作的异常问题，同时保留对Android API23的兼容性。
  • 7.2.0是7.2.x分支中最后一个支持Android API23的版本，7.2.1及后续版本依赖的Java特性不再兼容Android 6。
• 若倾向更稳定的旧版本，可尝试7.1.16：该版本修复了多个AcroForm相关bug，且完全兼容API23。

组件兼容注意事项 #

• 所有依赖的iText组件（如itext7-layout、itext7-fonts等）必须与itext7-core版本保持一致，避免版本不匹配引发异常。
• Android环境下需启用Java 8兼容，在build.gradle中添加配置：

  compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
  }
  

• 处理老旧PDF（如Adobe Acrobat 7生成的表单）时，建议获取AcroForm时启用allowPartialFormFill参数：

  PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDocument, true);
  form.setAllowPartialFormFill(true);
  

异常排查建议 #

若仍出现跳转到finally块的异常，需捕获具体异常信息（如PdfException），排查是否因老旧PDF的表单结构不规范导致，可尝试先用Adobe Acrobat重新保存PDF、修复表单结构后再进行填充。

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