使用PyPDF与ReportLab编辑PDF：特定位置图形文字被遮挡问题

我尝试使用PyPDF和ReportLab编辑现有PDF文件，当将红色圆形和红色文字定位到某一位置时，它们似乎被白色容器之类的元素遮挡，但定位到其他位置时显示正常，请问这是什么原因？

相关信息 #

• 示例PDF：一份关于申请建设公用电缆的官方文件
• 错误现象：指定位置的红色图形与文字被原PDF中的元素遮挡，其他位置显示正常
• 预期效果：红色内容能正常显示在目标位置
• 当前代码实现：

from PyPDF2 import PdfWriter, PdfReader
import io
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import letter
from reportlab.lib.colors import red

def main():
    packet = io.BytesIO()
    can = canvas.Canvas(packet, pagesize=letter)
    can.setFillColorRGB(1, 0, 0)
    can.circle(370,780,20,fill=1)
    can.setFillColor(red)
    can.setFont("Times-Roman", 14)
    can.drawString(352, 785, "Customer Group #22")
    can.save()

    packet.seek(0)
    new_pdf = PdfReader(packet)

    existing_pdf = PdfReader(open("samplePDF.pdf", "rb"))
    output = PdfWriter()

    page = existing_pdf.pages[1]
    page.merge_page(new_pdf.pages[0])
    output.add_page(page)

    outputStream = open("finalPDF.pdf", "wb")
    output.write(outputStream)
    outputStream.close()
if __name__ == "__main__":
    main()

原因解析 #

核心问题是PDF的图层渲染顺序：你当前使用的page.merge_page()方法，是把ReportLab生成的内容合并到现有PDF页面的底层。如果目标位置恰好存在原PDF中的不透明元素（比如白色背景的表格单元格、文本框），这些上层元素就会完全遮挡你的红色内容；而其他位置没有这类上层不透明元素，所以内容能正常显示。

解决方案 #

要让自定义内容显示在原PDF内容的上方，推荐使用PyPDF的add_overlay方法，专门用于将内容叠加到页面上层。修改后的代码如下：

from PyPDF2 import PdfWriter, PdfReader
import io
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import letter
from reportlab.lib.colors import red

def main():
    packet = io.BytesIO()
    can = canvas.Canvas(packet, pagesize=letter)
    can.setFillColorRGB(1, 0, 0)
    can.circle(370,780,20,fill=1)
    can.setFillColor(red)
    can.setFont("Times-Roman", 14)
    can.drawString(352, 785, "Customer Group #22")
    can.save()

    packet.seek(0)
    overlay_pdf = PdfReader(packet)

    existing_pdf = PdfReader(open("samplePDF.pdf", "rb"))
    output = PdfWriter()

    # 先添加原PDF页面
    page = existing_pdf.pages[1]
    output.add_page(page)
    # 使用add_overlay将自定义内容叠加到页面上层，page_number对应输出中页面的索引（从0开始）
    output.add_overlay(overlay_pdf.pages[0], page_number=0)

    # 更规范的文件写入方式
    with open("finalPDF.pdf", "wb") as outputStream:
        output.write(outputStream)

if __name__ == "__main__":
    main()

额外说明 #

如果你的PyPDF2版本较旧没有add_overlay方法，可以换一种合并顺序：先将ReportLab生成的空白页面加入输出，再把原PDF页面合并到它的下方，代码逻辑如下：

# 替换原合并逻辑
output.add_page(new_pdf.pages[0])
output.pages[0].merge_page(existing_pdf.pages[1])

这种方式需要确保两个页面的尺寸完全一致，否则会出现错位问题。

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