Python合并背景PDF与多页文本PDF遇问题[PyPDF2][Reportlab]

我猜你大概率是踩了PDF层顺序或者对象引用的坑——毕竟做这种固定背景+可变文本的PDF合并，这俩问题最常见。我给你整理了一套靠谱的实现方案，还把容易出错的点标出来了：

核心思路 #

本质就是把背景PDF的第一页（作为通用背景）和每个文本PDF的页面做层合并，确保文本在背景上方，然后把所有合并后的页面攒成最终的多页PDF。用IOBuffer没问题，但得避开操作误区。

修正后的完整代码 #

from PyPDF2 import PdfReader, PdfWriter
from io import BytesIO

def generate_form_pdfs(background_pdf_path, text_pdf_list, output_file_path):
    # 读取背景PDF的第一页作为通用背景
    bg_reader = PdfReader(background_pdf_path)
    base_bg_page = bg_reader.pages[0]

    final_writer = PdfWriter()

    for text_pdf_path in text_pdf_list:
        # 读取当前用户的文本PDF页面
        text_reader = PdfReader(text_pdf_path)
        text_page = text_reader.pages[0]

        # 关键：必须复制背景页的副本！
        # 如果直接用base_bg_page，所有页面都会共享同一个对象，最后全变成最后一次的结果
        bg_page_copy = base_bg_page.copy()
        
        # 把文本页合并到背景页上——文本会自动叠加在背景上方
        bg_page_copy.merge_page(text_page)

        # 将合并好的页面添加到最终PDF
        final_writer.add_page(bg_page_copy)

    # 写入最终文件，也可以用IOBuffer输出
    with open(output_file_path, "wb") as out_file:
        final_writer.write(out_file)

# 调用示例
background_path = "existing_pdf.pdf"
user_text_pdfs = ["user_form_1.pdf", "user_form_2.pdf", "user_form_3.pdf"]
generate_form_pdfs(background_path, user_text_pdfs, "final_forms.pdf")

避坑指南 #

• 层顺序别搞反：用merge_page把文本页合并到背景页上，比单独add_page可靠多了——后者容易因为添加顺序导致文本被背景盖住。
• 一定要复制背景页：如果循环里直接用同一个背景页对象，所有合并后的页面都会指向它，最后你会发现所有页面都是最后一个用户的文本，这是Python对象引用的坑，新手很容易踩。
• IOBuffer的正确打开方式：如果非要用IOBuffer临时存单页，写完后记得用temp_buffer.seek(0)把指针移到开头再读取，不然读出来是空的。

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