使用PDFBOX扁平化PDF表单时，如何保留可正常工作的按钮？

核心思路 #

默认的acroForm.flatten()会将所有表单字段转换为静态文本/图形，直接导致按钮失去交互性。要实现需求，需要只扁平化非按钮类型的表单字段，保留按钮字段的原有属性和交互功能。

具体实现步骤 #

• 遍历AcroForm中的所有字段，区分普通字段和按钮字段
• 对普通字段执行扁平化操作（将字段值转为静态内容，移除字段可编辑属性）
• 保留按钮字段的所有交互属性，不进行扁平化处理

代码示例 #

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.interactive.form.PDAcroForm;
import org.apache.pdfbox.pdmodel.interactive.form.PDField;
import org.apache.pdfbox.pdmodel.interactive.form.PDPushButton;

import java.io.File;
import java.io.IOException;

public class FlattenFormKeepButtons {
    public static void main(String[] args) throws IOException {
        try (PDDocument document = PDDocument.load(new File("input.pdf"))) {
            PDAcroForm acroForm = document.getDocumentCatalog().getAcroForm();
            if (acroForm == null) {
                return;
            }

            // 遍历字段，仅处理非按钮字段
            for (PDField field : acroForm.getFields()) {
                if (!(field instanceof PDPushButton)) {
                    // 扁平化单个字段，保留按钮的交互性
                    field.flatten();
                }
            }

            document.save("output.pdf");
        }
    }
}

关键说明 #

• 通过field instanceof PDPushButton精准判断字段类型，确保按钮字段不被处理
• 单个字段的flatten()方法仅作用于当前字段，不会影响按钮的外观和原有交互逻辑（如页面跳转、JS执行等）

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