如何使用pikepdf为PDF/A-1b标准PDF添加指定位置文本

add_overlay 方法仅接受合法的Form XObject对象作为输入，直接传入pikepdf原生字符串对象时，该对象缺少XObject必需的类型声明、边界框、资源引用、内容流等结构，因此抛出类型错误。

以下代码可直接运行，支持批量给多页PDF指定位置添加文本，默认保留原PDF的PDF/A-1b合规性，提供两种实现方式可选：直接追加内容流（更轻量）、构造Form XObject调用add_overlay（匹配最初的调用逻辑）。

import pikepdf
from pikepdf import Pdf, Page, Rectangle, Name, Dictionary, Array, String, Stream

# 基础配置
INPUT_PATH = "example.pdf"
OUTPUT_PATH = "example_with_text.pdf"
RENDER_TEXT = "Some date like 20220629"
# 文本放置区域：左下x、左下y、右上x、右上y，坐标原点在页面左下角
TEXT_AREA = Rectangle(50, 50, 300, 100)
FONT_SIZE = 12

with Pdf.open(INPUT_PATH) as pdf:
    # 注册PDF标准14字体Helvetica，PDF/A-1b兼容，无需额外嵌入文件
    font_alias = Name("/F1")
    if not hasattr(pdf.Root.Pages.Resources, "/Font"):
        pdf.Root.Pages.Resources.Font = Dictionary()
    if font_alias not in pdf.Root.Pages.Resources.Font:
        standard_font = pdf.make_indirect(Dictionary(
            Type=Name("/Font"),
            Subtype=Name("/Type1"),
            BaseFont=Name("/Helvetica"),
            Encoding=Name("/WinAnsiEncoding")
        ))
        pdf.Root.Pages.Resources.Font[font_alias] = standard_font

    for single_page in pdf.pages:
        current_page = Page(single_page)
        # 构造PDF合法文本内容流
        text_content = f"""
BT
/F1 {FONT_SIZE} Tf
{TEXT_AREA.llx} {TEXT_AREA.lly} Td
({RENDER_TEXT}) Tj
ET
""".encode("latin-1")

        # 方式1：直接追加到页面内容流，无需构造XObject，代码更简洁
        current_page.contents_add(text_content)

        # 方式2：构造合法Form XObject后调用add_overlay，和最初的调用逻辑匹配
        # overlay_xobj = pdf.make_indirect(Dictionary(
        #     Type=Name("/XObject"),
        #     Subtype=Name("/Form"),
        #     BBox=Array([0, 0, TEXT_AREA.width, TEXT_AREA.height]),
        #     Resources=Dictionary(Font=Dictionary(F1=standard_font)),
        #     stream=Stream(pdf, text_content)
        # ))
        # current_page.add_overlay(overlay_xobj, TEXT_AREA)

    # 保存时强制保留PDF/A合规属性
    pdf.save(OUTPUT_PATH, preserve_pdfa=True)

• 示例默认使用PDF标准内置Helvetica字体，仅支持拉丁类字符，若需要添加中文等非拉丁字符，需额外嵌入对应字体子集并调整编码规则
• 调整TEXT_AREA的四个参数即可修改文本位置，若需要调整字号直接修改FONT_SIZE变量即可
• 两种实现方式最终渲染效果一致，直接追加内容流的性能更好，构造XObject的方式更适合后续需要复用该文本块的场景
• 保存时传入preserve_pdfa=True参数会自动保留原PDF的PDF/A元数据与合规标识，不会导致输出文件脱离PDF/A-1b标准

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