调用setVisibility设PdfFormField为HIDDEN后扁平化仍不隐藏的问题

我之前也碰到过一模一样的情况——明明把PdfFormField设为HIDDEN了，但扁平化后字段还是冒出来。这通常是因为两个核心点没处理到位，咱们一步步来解决：

1. 确保字段和关联Widget都被设置为隐藏 #

PdfFormField的可见性设置有时候不会自动同步到它对应的Widget注释（PDF里实际负责渲染字段的元素）。所以你需要同时处理字段本身和它的Widget：

PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);
if (form != null) {
    Map<String, PdfFormField> fields = form.getFormFields();
    for (PdfFormField field : fields.values()) {
        // 设置字段为隐藏
        field.setVisibility(PdfFormField.HIDDEN);
        
        // 遍历字段关联的所有Widget，强制设置隐藏
        for (PdfWidgetAnnotation widget : field.getWidgets()) {
            widget.setHidden(true);
            // 如果需要确保字段完全不被渲染，也可以清除打印标志
            widget.clearFlag(PdfAnnotation.PRINT);
        }
    }
}

2. 检查PDF权限是否影响字段修改 #

你的removePdfPermissions()函数必须确保移除了所有限制表单修改的权限，否则设置字段可见性的操作会悄悄失效。这里给你一个可靠的权限移除实现：

private void removePdfPermissions() {
    PdfEncryptionSettings encryptionSettings = pdfDoc.getEncryptionSettings();
    // 允许修改内容和填写表单，确保字段属性可以被修改
    encryptionSettings.setPermissions(PdfWriter.ALLOW_MODIFY_CONTENTS | PdfWriter.ALLOW_FILL_IN);
    // 如果是旧版iText，可能需要用下面的方式（根据版本调整）：
    // pdfDoc.setEncryption(null, null, PdfWriter.ALLOW_MODIFY_CONTENTS | PdfWriter.ALLOW_FILL_IN, PdfWriter.ENCRYPTION_AES_256);
}

3. 正确执行扁平化操作 #

确保在设置完所有字段属性后再调用扁平化，并且使用iText 7的标准方法：

// 在设置完字段隐藏后执行
form.flattenFields();

完整示例代码 #

把这些整合起来，你的代码应该是这样的：

File file = new File("path to PDF file");
try (PdfDocument pdfDoc = new PdfDocument(new PdfReader(file.getAbsolutePath()), new PdfWriter("path to flattened PDF file"))) {
    // 先移除权限，确保能修改表单
    removePdfPermissions();
    
    PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);
    if (form != null) {
        Map<String, PdfFormField> fields = form.getFormFields();
        for (PdfFormField field : fields.values()) {
            field.setVisibility(PdfFormField.HIDDEN);
            // 同步处理Widget
            for (PdfWidgetAnnotation widget : field.getWidgets()) {
                widget.setHidden(true);
                widget.clearFlag(PdfAnnotation.PRINT);
            }
        }
        // 执行扁平化
        form.flattenFields();
    }
} catch (IOException e) {
    e.printStackTrace();
}

另外要注意：如果你的PDF里有嵌套的表单字段（比如分组字段），需要递归遍历所有子字段，确保每个字段都被设置为隐藏。

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