PDFBox 2.0.4填充PDF表单后扁平化下拉框值消失的解决办法

根据你描述的情况和提供的代码、PDF文件，这个问题主要出在下拉框字段的外观没有被正确生成，导致扁平化操作无法渲染出选中的值。下面是具体的解决步骤和原理：

问题根源 #

PDFBox的flatten()方法依赖字段已有的外观字典（Appearance Dictionary）来渲染内容。对于普通文本框，PDFBox通常能自动生成外观，但部分下拉框（尤其是像你提供的这种政府表单，可能没有预定义外观模板），默认情况下不会自动生成选中值的外观。你之前设置needAppearances=false和只读属性，只是告诉阅读器不要自动生成外观，但并没有让PDFBox主动生成外观，所以扁平化后下拉框就空了。

具体解决方案 #

1. 手动刷新字段外观（核心步骤） #

在设置完所有字段值之后，遍历所有字段并调用refreshAppearance()方法，强制PDFBox为每个字段生成对应的外观流。这一步是让扁平化能正确显示值的关键。

修改你的代码，在设置完字段值后添加以下逻辑：

// 设置完所有字段值后执行
for (PDField field : acroForm.getFields()) {
    // 可选：将字段设为只读，防止后续编辑
    field.setReadOnly(true);
    // 强制生成字段外观
    try {
        field.refreshAppearance();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

2. 调整needAppearances的设置顺序 #

先将needAppearances设为true，让PDFBox优先处理外观生成，之后再设为false避免阅读器干扰：

acroForm.setNeedAppearances(true);
// （这里是设置字段值+刷新外观的代码）
acroForm.setNeedAppearances(false);

3. 确认下拉框值的正确性 #

确保你设置的下拉框值是该字段的有效选项值（注意区分显示文本和导出值）。可以通过以下代码查看下拉框的所有选项，确认你设置的值是否存在：

PDChoiceField choiceField = (PDChoiceField) acroForm.getField("NEV_JOGSZABALY");
// 打印所有选项的显示文本和导出值
for (int i = 0; i < choiceField.getOptions().size(); i++) {
    String displayText = choiceField.getOptions().get(i);
    String exportValue = choiceField.getExportValues() != null ? choiceField.getExportValues().get(i) : displayText;
    System.out.println("显示文本：" + displayText + " | 导出值：" + exportValue);
}

如果你的设置值是显示文本，但该选项的导出值不同，需要改用导出值来调用setValue()。

4. 升级PDFBox版本（可选但推荐） #

你使用的2.0.4版本比较老旧，存在一些关于表单处理的已知bug。升级到最新的2.x稳定版本（比如2.0.32），能避免很多类似的兼容性问题。

完整修改后的代码片段 #

结合以上步骤，你的代码可以调整成这样：

PDDocument document = PDDocument.load(new File("input.pdf"));
PDAcroForm acroForm = document.getDocumentCatalog().getAcroForm();

// 设置普通文本框值
PDField textField = acroForm.getField("NEV_OLDAL");
textField.setValue("Test Value");

// 设置下拉框值
PDField choiceField = acroForm.getField("NEV_JOGSZABALY");
if (choiceField instanceof PDChoiceField) {
    ((PDChoiceField) choiceField).setValue("Államkincstár");
}

// 刷新所有字段外观
acroForm.setNeedAppearances(true);
for (PDField field : acroForm.getFields()) {
    field.setReadOnly(true);
    try {
        field.refreshAppearance();
    } catch (IOException e) {
        e.printStackTrace();
    }
}
acroForm.setNeedAppearances(false);

// 扁平化表单
acroForm.flatten();

document.save(new File("output.pdf"));
document.close();

这样处理后，下拉框的选中值应该就能在扁平化后的PDF中正常显示了。

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