DocuSign签名后PDF表单字段丢失问题排查求助

DocuSign签名后默认会扁平化（flatten）PDF表单——也就是把可编辑的表单字段转换成普通的文本/图形内容，不再保留原有的AcroForm结构，这就是你用PDFBox获取不到"date"字段的核心原因；而Adobe Sign默认不会自动扁平化表单，所以能正常获取字段。

解决思路一：修改DocuSign签名设置（最优方案） #

在DocuSign发送文档进行签名时，找到「完成后处理文档」的设置选项，关闭「扁平化文档」或者「将表单字段转换为静态文本」之类的开关。这样签名后的PDF会保留原有的AcroForm字段结构，你的原有代码就能正常工作。

解决思路二：排查字段是否被重命名或隐藏 #

如果无法修改DocuSign设置，可以先遍历PDF中所有现存字段，确认目标字段是否存在或被重命名：

PDDocument agreementDocument = PDDocument.load(file);
PDAcroForm acroForm = agreementDocument.getDocumentCatalog().getAcroForm();

if (acroForm != null) {
    // 打印所有字段的完整名称，排查是否有目标字段
    for (PDField field : acroForm.getFields()) {
        System.out.println("存在的字段名：" + field.getFullyQualifiedName());
    }
    PDTextField dateField = (PDTextField) acroForm.getField("date");
    if (dateField != null) {
        dateField.setReadOnly(true);
        dateField.setValue(new SimpleDateFormat("MM/dd/yyyy").format(date));
    } else {
        System.out.println("未找到名为date的字段");
    }
} else {
    System.out.println("文档无AcroForm结构（已被扁平化）");
}

如果发现字段名被DocuSign修改（比如加上了前缀），直接用新的字段名获取即可。

解决思路三：为扁平化的PDF添加新字段 #

如果PDF已经被完全扁平化（无AcroForm结构），可以手动在指定位置添加新的日期字段：

PDDocument agreementDocument = PDDocument.load(file);
PDAcroForm acroForm = agreementDocument.getDocumentCatalog().getAcroForm();

// 如果没有AcroForm，创建一个新的
if (acroForm == null) {
    acroForm = new PDAcroForm(agreementDocument);
    agreementDocument.getDocumentCatalog().setAcroForm(acroForm);
}

// 创建新的日期字段
PDTextField dateField = new PDTextField(acroForm);
dateField.setPartialName("date");
dateField.setValue(new SimpleDateFormat("MM/dd/yyyy").format(date));
dateField.setReadOnly(true);

// 设置字段的位置和尺寸（需要根据你的PDF实际坐标调整）
// 坐标规则：左下角为原点(0,0)，x向右递增，y向上递增
PDRectangle fieldRect = new PDRectangle(150, 300, 180, 25); // x, y, width, height
PDAnnotationWidget widget = new PDAnnotationWidget();
widget.setRectangle(fieldRect);
widget.setPage(agreementDocument.getPage(0)); // 指定字段在第1页
widget.setAnnotationFlags(PDAnnotation.FLAGS_PRINT); // 设置字段可打印

// 将字段和控件关联并添加到文档
dateField.getWidgets().add(widget);
acroForm.getFields().add(dateField);
agreementDocument.getPage(0).getAnnotations().add(widget);

// 保存修改后的文档
agreementDocument.save("modified_document.pdf");
agreementDocument.close();

注意：字段的坐标需要你通过Adobe Acrobat等工具查看原日期字段的位置后填入。

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