复制PDF页面后PdfPopupAnnotation的Parent对象无法访问求助

你遇到的这个问题确实有点棘手——明明PDF文件里的Parent引用完整存在，但iText就是没法通过getParentObject()拿到对应的父注解。我来帮你拆解一下原因和解决办法：

问题原因 #

这本质上是iText处理注解间接引用时的一个小问题。虽然copyPagesTo方法完整拷贝了注解的字典内容（包括Parent条目），但在加载新文档时，PdfPopupAnnotation.getParentObject()的自动解析逻辑可能因为懒加载机制，或者旧版本的bug，没能正确将间接引用转换为PdfAnnotation对象。从你提供的PDF片段来看，父注解确实存在，只是iText的封装方法没完成最后一步解析。

解决方案 #

这里有几个可行的处理方式，你可以根据自己的场景选择：

1. 手动解析Parent引用 #

绕过封装的getParentObject()，直接操作PDF底层对象来获取父注解：

if (annot instanceof PdfPopupAnnotation) {
    PdfPopupAnnotation popup = (PdfPopupAnnotation) annot;
    // 获取Parent的间接引用
    PdfIndirectReference parentRef = popup.getPdfObject().getAsIndirectReference(PdfName.Parent);
    if (parentRef != null) {
        // 从文档中取出对应的字典并转为注解对象
        PdfDictionary parentDict = doc.getPdfObject(parentRef);
        PdfAnnotation parentAnnot = PdfAnnotation.makeAnnotation(parentDict);
        System.out.println(parentAnnot.getPdfObject());
    } else {
        System.out.println(null);
    }
}

这种方式直接走底层逻辑，能确保拿到正确的父注解。

2. 升级iText版本 #

如果你用的是iText 7的旧版本（比如7.1.x及更早），这个问题大概率已经在新版本中被修复了。建议升级到最新的稳定版，新版本对注解引用的处理更加严谨。

3. 复制后手动修复双向引用 #

如果需要保持注解之间的双向关联（父注解的Popup指向弹窗，弹窗的Parent指向父注解），可以在复制页面后手动建立关系：

// 复制页面完成后，关闭输出文档前执行以下代码
for (int i = 1; i <= outputDoc.getNumberOfPages(); i++) {
    PdfPage page = outputDoc.getPage(i);
    Map<PdfIndirectReference, PdfAnnotation> annotMap = new HashMap<>();
    
    // 先把所有注解存入Map，方便快速查找
    for (PdfAnnotation annot : page.getAnnotations()) {
        annotMap.put(annot.getPdfObject().getIndirectReference(), annot);
    }
    
    // 遍历弹窗注解，修复Parent和Popup的双向引用
    for (PdfAnnotation annot : page.getAnnotations()) {
        if (annot instanceof PdfPopupAnnotation) {
            PdfPopupAnnotation popup = (PdfPopupAnnotation) annot;
            PdfIndirectReference parentRef = popup.getPdfObject().getAsIndirectReference(PdfName.Parent);
            if (parentRef != null && annotMap.containsKey(parentRef)) {
                PdfAnnotation parentAnnot = annotMap.get(parentRef);
                popup.setParent(parentAnnot);
                parentAnnot.setPopup(popup);
            }
        }
    }
}

处理完之后，再调用getParentObject()就能正常获取到父注解了。

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