使用pypdf添加PDF印章：简单PDF无效，复杂PDF正常

我参考pypdf官方文档实现PDF叠加（或文字叠加），现有代码对部分复杂overlay.pdf有效，但对某简单overlay.pdf无效——仅能看到基础PDF，叠加层完全不显示。

现有叠加代码 #

from pypdf import PdfWriter, PdfReader

stamp = PdfReader("overlay.pdf").pages[0]
writer = PdfWriter(clone_from="form_1099_nec_page_4.pdf")
for page in writer.pages:
    page.merge_page(stamp, over=True)

writer.write("merged.pdf")

overlay.pdf生成代码（供参考） #

wkhtmltopdf_path = getattr(settings, 'WKHTMLTOPDF_PATH', None)
config = pdfkit.configuration(wkhtmltopdf=wkhtmltopdf_path)
with open('overlay.html', 'r') as html_file:
    html_content = html_file.read()

pdf_data = pdfkit.from_string(html_content, False, configuration=config)

with open('overlay.pdf', 'wb') as pdf_file:
    pdf_file.write(pdf_data)

可能的原因及解决方案 #

1. 页面尺寸不匹配 #

wkhtmltopdf默认生成A4尺寸PDF，若基础PDF是其他尺寸（如美国信纸8.5×11英寸），叠加层会偏移到可见区域外。
解决： 生成overlay时指定与基础PDF一致的尺寸：

options = {
    'page-size': 'letter',  # 匹配基础PDF尺寸
    'margin-top': '0in',
    'margin-right': '0in',
    'margin-bottom': '0in',
    'margin-left': '0in'
}
pdf_data = pdfkit.from_string(html_content, False, configuration=config, options=options)

2. 内容定位或裁剪问题 #

HTML中的元素可能超出页面范围，或wkhtmltopdf自动缩放导致内容不可见。
解决：

• 检查HTML布局，确保元素在页面尺寸范围内
• 添加disable-smart-shrinking参数禁用自动缩放：

options = {
    # 其他参数...
    'disable-smart-shrinking': ''
}

3. pypdf叠加方法兼容性问题 #

merge_page对部分PDF结构支持不佳，可尝试add_overlay方法：

from pypdf import PdfWriter, PdfReader

reader_base = PdfReader("form_1099_nec_page_4.pdf")
reader_stamp = PdfReader("overlay.pdf")
stamp_page = reader_stamp.pages[0]

writer = PdfWriter()
for page in reader_base.pages:
    page.add_overlay(stamp_page)
    writer.add_page(page)

writer.write("merged.pdf")

4. overlay.pdf图层/透明度问题 #

部分PDF阅读器或生成工具会将内容放在底层，或透明度设置为0。
解决： 用PDF阅读器打开overlay.pdf，确认内容可见；若生成的PDF有透明层，可尝试在HTML中明确设置不透明度：

body { opacity: 1; }

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