iText 7.2.5版本PdfAcroForm无getAllFormFields如何获取所有表单域？

iText 7.2.5版本的getFormFields()方法仅返回顶层表单域，如果表单存在嵌套结构（比如域被放在PdfFormField容器中），这些嵌套域不会被自动纳入返回结果，因此会出现返回空Map或域不完整的情况。你可以通过递归遍历顶层域及其子域的方式，手动收集所有表单域，具体实现如下：

实现步骤 #

1. 获取PDF表单实例：

PdfDocument pdfDoc = new PdfDocument(new PdfReader("你的PDF文件路径"));
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, false);

2. 编写递归方法收集所有域：

private static void collectAllFormFields(PdfFormField field, Map<String, PdfFormField> allFields) {
    // 添加当前域到集合（过滤无名称的容器域）
    if (field.getFieldName() != null && !field.getFieldName().isEmpty()) {
        allFields.put(field.getFieldName(), field);
    }
    // 递归处理所有子域
    for (PdfFormField childField : field.getChildren()) {
        collectAllFormFields(childField, allFields);
    }
}

3. 调用方法获取完整表单域集合：

Map<String, PdfFormField> allFormFields = new HashMap<>();
if (form != null) {
    // 遍历所有顶层域，递归收集子域
    for (PdfFormField topField : form.getFormFields().values()) {
        collectAllFormFields(topField, allFormFields);
    }
}
// allFormFields即为包含所有层级的表单域集合

补充说明 #

• 若form.getFormFields()返回空Map，先确认目标PDF确实包含AcroForm表单结构（可通过PDF阅读器的表单编辑功能验证）；
• 如果是动态XFA表单，需调用form.getXfaForm()进行处理，这类场景在普通业务中较少见。

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