PDFbox 2.0.25复制可填字段后Acrobat不显示值问题求助

我开发了一款表单填充程序，功能是接收带多行可填字段的PDF模板和字段值JSON数据，将值填充到表单中。当行数超出单页容量时，会复制页面并将多余行添加至复制页。页面经深度克隆后，修改了页面注释的T值、注释关联页面，并为新页创建新字段。导出的PDF在Chrome中能正常显示新页的字段值，但在Acrobat中无法显示。虽然通过Chrome重新保存PDF能让Acrobat显示值，但会丢失可填字段，我不想让用户采用这种临时办法。由于对PDF规范了解不深，附上页面复制的核心代码，希望熟悉PDF的开发者指出问题并提供修复方案。

核心代码 #

private void createContent(PDDocument document, JSONObject jsonObj) throws IOException {

    final PDAcroForm acroForm = document.getDocumentCatalog().getAcroForm();
    final JSONArray rowsArr = (JSONArray)jsonObj.get("rows");
    final int pages = (int)Math.ceil(rowsArr.size() / 34.0);
    
    if (pages > 1)
    {
        // 添加额外页面
        final PDFCloneUtility cloner = new PDFCloneUtility(document);
        final PDPage oldPage = document.getPage(0);

        for (int i=1; i < pages; i++)
        {
            final COSDictionary dupPageDict = (COSDictionary)cloner.cloneForNewDocument(oldPage);
            final PDPage dupPage = new PDPage(dupPageDict);

            final List<PDAnnotation> dupAnnoList = dupPage.getAnnotations();
            for (PDAnnotation anno : dupAnnoList)
            {
                final COSDictionary annoDict = anno.getCOSObject();
                final String oldTStr = annoDict.getString(COSName.T); // 字段名，例: INC0

                // 修改注释关联页面并为其创建字段
                if (oldTStr.endsWith(String.valueOf(i-1)))
                {
                    // 修改页面关联并添加到新页
                    anno.setPage(dupPage);
                    dupPage.getAnnotations().add(anno);

                    // 更新注释的新页面字段名
                    final String dupTStr = oldTStr.substring(0, oldTStr.length() - 1) + i; // 例: INC1
                    annoDict.setItem(COSName.T, new COSString(dupTStr));

                    annoDict.setItem(COSName.AP, null);

                    // 所有字段均为文本字段
                    COSBase ftBase = annoDict.getItem(COSName.FT);
                    if (ftBase instanceof COSName && COSName.TX == ftBase)
                    {
                        final PDTextField oldField = (PDTextField) acroForm.getField(oldTStr);
                        if (oldField != null)
                        {
                            // 为注释创建新字段
                            final PDTextField dupField = new PDTextField(acroForm);
                            dupField.setPartialName(dupTStr);
                            dupField.setDefaultAppearance(oldField.getDefaultAppearance());

                            if (anno instanceof PDAnnotationWidget)
                            {
                                dupField.getWidgets().add((PDAnnotationWidget) anno);
                                acroForm.getFields().add(dupField);
                            }
                        }
                    }
                }
            }

            // 把新页插入到说明页之前（说明页在文档末尾）
            final PDPageTree pgTree = document.getDocumentCatalog().getPages();
            pgTree.insertBefore(dupPage, pgTree.get(pgTree.getCount() - 1));
        }
    }
    
    PDFont font = PDType1Font.HELVETICA;
    PDResources resources = new PDResources();
    resources.put(COSName.getPDFName("Helv"), font);
    acroForm.setDefaultResources(resources);
    
    for (int i = 0; i < pages; i++)
    {
        addHeaderInfo(acroForm, jsonObj, i);
        addMainInfo(acroForm, rowsArr, i);
        addFooterInfo(acroForm, jsonObj, i);
    }
}

1. Widget与字段的Parent关联缺失：Acrobat严格依赖Widget注释的Parent字段来关联对应的表单字段，Chrome的PDF渲染对该关联要求较低。代码中未设置新Widget的Parent指向新创建的字段，导致Acrobat无法识别字段与Widget的绑定关系。
2. 字段属性不完整：新创建的PDTextField仅复制了默认外观，未复制原字段的字段标志、值初始化等核心属性，导致Acrobat无法正确解析字段状态。
3. Widget重复添加：dupPage.getAnnotations().add(anno)属于冗余操作，因为dupAnnoList已经是新页的注释集合，重复添加会导致注释字典出现冲突，干扰Acrobat解析。
4. AP外观字典处理错误：直接将AP设为null会让Acrobat失去字段外观流的引用，Chrome可动态生成外观，但Acrobat依赖预定义的外观字典。

1. 正确设置Widget的Parent关联 #

创建新字段后，必须将Widget的Parent字段指向新字段的COS字典，确保Acrobat能识别归属关系：

if (anno instanceof PDAnnotationWidget) {
    PDAnnotationWidget widget = (PDAnnotationWidget) anno;
    dupField.getWidgets().add(widget);
    // 绑定Widget到新字段
    widget.getCOSObject().setItem(COSName.PARENT, dupField.getCOSObject());
    acroForm.getFields().add(dupField);
}

2. 完整复制原字段核心属性 #

除默认外观外，还需复制字段标志、初始化值等属性，保证新字段与原字段行为一致：

final PDTextField dupField = new PDTextField(acroForm);
dupField.setPartialName(dupTStr);
// 复制原字段的标志位
dupField.setFieldFlags(oldField.getFieldFlags());
// 继承默认外观
dupField.setDefaultAppearance(oldField.getDefaultAppearance());
// 初始化字段值（避免Acrobat识别为空字段）
dupField.setValue("");

3. 移除冗余的Widget添加操作 #

删除dupPage.getAnnotations().add(anno)，因为dupAnnoList已经是新页的注释列表，遍历处理时已关联到新页，重复添加会导致字典冲突。

4. 正确处理AP外观字典 #

不要直接设为null，而是移除原AP字典，让PDFBox在保存时自动生成符合规范的外观：

// 移除原AP字典，后续通过refreshAppearance生成新外观
annoDict.removeItem(COSName.AP);
// 设置字段值后调用刷新外观
dupField.setValue(yourValue);
dupField.refreshAppearance();

修复后的核心代码片段 #

for (int i=1; i < pages; i++)
{
    final COSDictionary dupPageDict = (COSDictionary)cloner.cloneForNewDocument(oldPage);
    final PDPage dupPage = new PDPage(dupPageDict);

    final List<PDAnnotation> dupAnnoList = dupPage.getAnnotations();
    for (PDAnnotation anno : dupAnnoList)
    {
        final COSDictionary annoDict = anno.getCOSObject();
        final String oldTStr = annoDict.getString(COSName.T);

        if (oldTStr.endsWith(String.valueOf(i-1)))
        {
            anno.setPage(dupPage);
            final String dupTStr = oldTStr.substring(0, oldTStr.length() - 1) + i;
            annoDict.setItem(COSName.T, new COSString(dupTStr));

            // 移除原AP字典，后续自动生成
            annoDict.removeItem(COSName.AP);

            COSBase ftBase = annoDict.getItem(COSName.FT);
            if (ftBase instanceof COSName && COSName.TX.equals(ftBase))
            {
                final PDTextField oldField = (PDTextField) acroForm.getField(oldTStr);
                if (oldField != null)
                {
                    final PDTextField dupField = new PDTextField(acroForm);
                    dupField.setPartialName(dupTStr);
                    dupField.setFieldFlags(oldField.getFieldFlags());
                    dupField.setDefaultAppearance(oldField.getDefaultAppearance());
                    dupField.setValue("");

                    if (anno instanceof PDAnnotationWidget)
                    {
                        PDAnnotationWidget widget = (PDAnnotationWidget) anno;
                        dupField.getWidgets().add(widget);
                        widget.getCOSObject().setItem(COSName.PARENT, dupField.getCOSObject());
                        acroForm.getFields().add(dupField);
                    }
                }
            }
        }
    }

    final PDPageTree pgTree = document.getDocumentCatalog().getPages();
    pgTree.insertBefore(dupPage, pgTree.get(pgTree.getCount() - 1));
}

内容的提问来源于stack exchange，提问作者Barn on a Hill