使用pdfrw复制PDF页面后操作Root.AcroForm报错：PdfWriter has no Root

问题原因 #

pdfrw.PdfWriter实例默认不会自动初始化Root属性，直接访问pdfs.Root.AcroForm会触发"PdfWriter has no Root"错误。

修复方案 #

需要先将原PDF的Root（或至少AcroForm节点）复制到PdfWriter实例中，或者手动创建对应的节点结构。以下是两种可行的修改方式：

方式一：继承原PDF的完整Root结构 #

如果需要保留原PDF的所有根节点配置，直接将读取到的PDF的Root赋值给PdfWriter：

import pdfrw

pdf_template = "your_template_path.pdf"
pdf = pdfrw.PdfReader(pdf_template)
pdfs = pdfrw.PdfWriter()

for page in pdf.pages:
    # 你的页面操作代码
    pdfs.addpage(page)

# 继承原PDF的Root节点
pdfs.Root = pdf.Root
# 更新NeedAppearances属性
pdfs.Root.AcroForm.update(pdfrw.PdfDict(NeedAppearances=pdfrw.PdfObject('true')))

# 保存输出PDF
pdfs.write("output.pdf")

方式二：仅初始化AcroForm节点（适用于原PDF无表单的场景） #

如果原PDF没有AcroForm结构，或者只需要创建新的表单配置，可以手动创建Root和AcroForm：

import pdfrw

pdf_template = "your_template_path.pdf"
pdf = pdfrw.PdfReader(pdf_template)
pdfs = pdfrw.PdfWriter()

for page in pdf.pages:
    # 你的页面操作代码
    pdfs.addpage(page)

# 初始化Root和AcroForm节点
if not hasattr(pdfs, 'Root'):
    pdfs.Root = pdfrw.PdfDict()
if not hasattr(pdfs.Root, 'AcroForm'):
    pdfs.Root.AcroForm = pdfrw.PdfDict()

# 更新NeedAppearances属性
pdfs.Root.AcroForm.update(pdfrw.PdfDict(NeedAppearances=pdfrw.PdfObject('true')))

# 保存输出PDF
pdfs.write("output.pdf")

关键说明 #

• NeedAppearances属性用于让PDF阅读器自动生成表单字段的外观，确保填充后的表单内容正常显示。
• 无论哪种方式，核心都是先确保PdfWriter实例的Root和AcroForm节点存在，再进行属性更新。

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