使用PyPDF2创建空白页并添加文本时触发AttributeError的原因

1. 模块结构变更：PyPDF2 3.0.0+ 对内部模块做了重构，pdf子模块不再作为顶层属性对外暴露，直接通过PyPDF2.pdf访问必然触发AttributeError。
2. 私有API依赖：你代码里用的_pdf.PageObject、TextStringObject、TextObject都是内部私有接口，这类接口不会出现在官方公开文档中——你可能误将内部实现细节当成了公开API。私有接口没有版本兼容性承诺，版本迭代时随时会被修改或移除。

PyPDF2本身对文本渲染的支持有限，推荐两种可靠实现方式：

方案1：仅用PyPDF2（适合简单文本注释） #

利用PyPDF2的公开API创建空白页，通过文本注释添加内容：

from PyPDF2 import PdfWriter
from PyPDF2.generic import AnnotationBuilder

def add_text_to_blank_page(pdf_writer, text):
    # 创建标准US Letter尺寸的空白页
    blank_page = PdfWriter.create_blank_page(width=612, height=792)
    
    # 添加文本注释（控制位置、字体、大小）
    text_annot = AnnotationBuilder.free_text(
        text,
        rect=(50, 700, 550, 750),  # 文本区域：(左, 下, 右, 上)
        font="Helvetica",
        font_size=12,
        font_color="black"
    )
    blank_page.add_annotation(text_annot)
    
    # 将页面追加到PDF Writer
    pdf_writer.add_page(blank_page)

方案2：结合ReportLab（推荐，支持复杂文本渲染） #

ReportLab是专业的PDF生成库，能实现更灵活的文本排版，先安装依赖：

pip install reportlab

实现代码：

from PyPDF2 import PdfWriter, PdfReader
from reportlab.pdfgen import canvas
from io import BytesIO

def add_text_to_blank_page(pdf_writer, text):
    # 用ReportLab生成带文本的临时页面
    temp_buffer = BytesIO()
    c = canvas.Canvas(temp_buffer, pagesize=(612, 792))  # US Letter尺寸
    
    # 设置字体和大小，绘制文本（坐标从页面左下角开始计算）
    c.setFont("Helvetica", 12)
    c.drawString(50, 750, text)
    c.save()
    
    # 将临时页面读取并追加到目标PDF Writer
    temp_buffer.seek(0)
    temp_reader = PdfReader(temp_buffer)
    pdf_writer.add_page(temp_reader.pages[0])

• 永远不要依赖PyPDF2的私有API（名称以_开头的模块/类），这类接口不受官方支持，版本升级后极易失效。
• PyPDF2的核心优势是PDF的合并、拆分、加密等操作，复杂的文本/图形渲染建议搭配专业生成库。

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