如何解决pypdf修改PDF表单字段时的/AcroForm字典缺失错误？

问题根源 #

1. 缺少AcroForm字典：PdfWriter默认不会自动创建表单所需的/AcroForm字典，原PDF的表单结构存储在PdfReader的/AcroForm中，需要手动复制到Writer对象。
2. 字段名使用错误：代码中用数字索引（如{0: "some filled in text"}）指定字段无效，必须使用get_fields()返回的实际字段名称作为键。

修正后的完整代码 #

from pypdf import PdfReader, PdfWriter

reader = PdfReader("exmpl3.pdf")
writer = PdfWriter()

# 复制原PDF的AcroForm字典到Writer，解决"No /AcroForm dictionary"错误
if "/AcroForm" in reader._root_object:
    writer._root_object.update(
        reader._root_object["/AcroForm"].copy()
    )

# 添加需要修改的页面
page = reader.pages[0]
writer.add_page(page)

# 获取并打印所有可用字段（用于确认字段名）
fields = reader.get_fields()
for idx, field_name in enumerate(fields):
    print(idx, field_name)

# 定义要填充的字段值：键为实际字段名，值为对应内容
# 注意：复选框选中用"/Yes"，取消用"/Off"；单选按钮需匹配选项值
field_values = {
    "form1[0].#subform[0].TextField1[0]": "填充的文本内容",
    "form1[0].#subform[0].CheckBox1[0]": "/Yes"
}

# 更新表单字段值
writer.update_page_form_field_values(writer.pages[0], field_values)

# 保存修改后的PDF
with open("filled-out.pdf", "wb") as output_stream:
    writer.write(output_stream)

关键说明 #

• 必须先复制/AcroForm字典再添加页面，否则表单结构无法被Writer识别。
• 字段名必须完全匹配get_fields()输出的名称，比如form1[0].#subform[0].TextField1[0]这类格式。
• 特殊字段值格式：
  • 复选框：选中状态设为"/Yes"，未选中设为"/Off"。
  • 单选按钮：需设置为对应选项的预设值（可通过查看原PDF表单属性获取）。
  • 日期字段：需匹配原表单要求的日期格式（如"2024-05-20"）。

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