iTextSharp填充PDF后复选框在Adobe Reader X中消失问题求助

我之前处理过不少Acrobat新旧版本间的表单兼容性问题，你的场景（部分字段扁平化、部分保留可编辑，Reader X复选框消失）确实是个典型的版本兼容坑，下面是经过验证的修复方案：

问题根源 #

Adobe Reader X对iTextSharp默认的字段渲染逻辑支持不佳，尤其是在扁平化字段与可编辑字段共存的场景下，即使模板提前启用了使用权限，也会因为字段外观未正确生成、权限被重置等原因导致复选框无法显示。

具体修复步骤 #

1. 优先确保字段外观生成 #

Reader X不像DC那样能动态渲染字段外观，必须强制iTextSharp为所有字段生成明确的外观。在初始化PdfStamper后立即添加这行代码：

var stamper = new PdfStamper(reader, new FileStream(outputPath, FileMode.Create));
stamper.AcroFields.GenerateAppearances = true; // 关键：强制生成字段外观

2. 调整字段处理顺序 #

不要在填充值后立即扁平化字段，先完成所有字段的赋值，再标记需要锁定的字段为只读（这种方式比直接扁平化更兼容旧版本）：

var form = stamper.AcroFields;

// 1. 先填充所有字段值，复选框要对应模板的导出值（通常是"On"/"Off"）
form.SetField("AgreementCheckbox", "On");
form.SetField("UserName", "用户可填写内容");

// 2. 标记需要禁止编辑的字段为只读
var fieldsToLock = new List<string> { "AgreementCheckbox", "FormID" };
foreach (var fieldName in fieldsToLock)
{
    form.SetFieldProperty(fieldName, "setfflags", PdfFormField.FF_READ_ONLY, null);
}

如果业务必须扁平化指定字段，不要调用全局的stamper.FormFlattening = true（这会扁平化所有字段），而是用字段级别的扁平化：

// 仅扁平化指定字段
form.FlattenField("AgreementCheckbox");

3. 重新保留/设置使用权限 #

iTextSharp修改表单后会重置模板的权限配置，所以在关闭PdfStamper前，需要重新设置允许填写的权限：

// 设置允许用户填写表单的权限，兼容Reader X
stamper.SetEncryption(
    null, 
    null, 
    PdfWriter.ALLOW_FILL_IN | PdfWriter.ALLOW_SCREENREADERS, 
    PdfWriter.STANDARD_ENCRYPTION_128
);

// 保留模板原有的元数据和信息，避免权限丢失
stamper.MoreInfo = reader.Info;
stamper.XmpMetadata = reader.Metadata;

4. 验证模板的复选框配置 #

打开你的PDF模板，在Acrobat中检查复选框的配置：

• 右键复选框 → 属性 → 选项
• 确认"导出值"是标准的On（不要用自定义值，比如"Y"，Reader X对非标准值的支持很差）

测试验证 #

按照上述步骤修改代码后，生成的PDF在Reader X中应该能正常显示复选框，同时锁定的字段无法编辑，可编辑字段能正常填写，后续程序也能读取到用户输入的数据。

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