PyPDF2填充PDF表单后在不同阅读器显示不一致问题求助

问题描述 #

预期生成的PDF包含两页，分别显示“page1”和“page2”：

实际运行代码后，生成的PDF在Mac预览、Safari中显示正常，但在Chrome、Brave、Adobe阅读器中打开时，所有页面均显示第一页内容（“page1”），即使生成n页也全部重复该内容：

代码示例 #

# 原始PDF请从IRS官网下载并保存到path路径
from PyPDF2 import PdfReader, PdfWriter  

writer = PdfWriter()

reader = PdfReader(path)
page = reader.pages[0]
writer.add_page(page)
writer.update_page_form_field_values(writer.pages[0], {"f1_3[0]":"page1"})

reader = PdfReader(path)
page = reader.pages[0]
writer.add_page(page)
writer.update_page_form_field_values(writer.pages[1], {"f1_3[0]":"page2"})

with open("output.pdf", "wb") as output_stream:
        writer.write(output_stream)
        output_stream.close()

环境信息 #

• PyPDF2==2.11.2
• PyPDF4==1.27.0
• Python 3.9.7
• Mac 12.1
• Brave 1.45.127
• Adobe 2022.003.20258

显示兼容性 #

• 正常：Safari、Mac预览
• 异常：Chrome、Adobe、Brave

问题原因 #

直接复用同一源页面实例时，PyPDF2并未完全隔离页面内表单字段的底层字典引用，多页共享了相同的字段标识符。Safari、Mac预览对PDF规范的兼容性处理更宽松，会单独解析每页字段；而Chrome、Adobe等严格遵循规范的阅读器会将共享标识符的字段判定为同一字段，最终显示相同内容。

解决方法 #

每次添加页面时对源页面进行深层复制，确保每页的表单字段引用完全独立：

# 原始PDF请从IRS官网下载并保存到path路径
from PyPDF2 import PdfReader, PdfWriter  

writer = PdfWriter()

reader = PdfReader(path)
# 复制页面后再添加，避免共享字段引用
page = reader.pages[0].copy()
writer.add_page(page)
writer.update_page_form_field_values(writer.pages[0], {"f1_3[0]":"page1"})

reader = PdfReader(path)
page = reader.pages[0].copy()
writer.add_page(page)
writer.update_page_form_field_values(writer.pages[1], {"f1_3[0]":"page2"})

with open("output.pdf", "wb") as output_stream:
        writer.write(output_stream)
        output_stream.close()

若使用的PyPDF2版本支持，也可调用writer.clone_page()方法实现页面克隆，效果一致：

page = reader.pages[0]
cloned_page = writer.clone_page(page)
writer.add_page(cloned_page)

修改后，所有阅读器均可正确显示每页的独立表单内容。

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