Python插入PDF二维码：实现100%缩放可扫描及右上角定位求助

核心问题原因 #

• 二维码尺寸过小：100%缩放时，手机摄像头无法捕捉到足够清晰的二维码模块细节
• 容错率设置不足：PDF渲染或显示时的轻微模糊，会导致低容错率的二维码无法被识别
• 插入时过度压缩：将高分辨率二维码缩至过小尺寸，丢失了模块细节

具体解决方案 #

1. 生成高分辨率、高容错的二维码

生成时要保证足够的模块大小、边框和最高容错率，避免细节丢失：

import qrcode

# 配置二维码参数：高版本、最高容错、大模块尺寸
qr = qrcode.QRCode(
    version=4,  # 对应33x33模块，兼顾内容容量和尺寸
    error_correction=qrcode.constants.ERROR_CORRECT_H,  # 允许30%模块损坏，适配模糊场景
    box_size=10,  # 每个模块占10像素，提升整体分辨率
    border=4,  # 符合标准的最小边框，避免边缘干扰
)
qr.add_data("你的二维码目标内容")
qr.make(fit=True)
# 保存为高清PNG，避免JPEG压缩失真
img = qr.make_image(fill_color="black", back_color="white")
img.save("high_def_qr.png")

2. 插入PDF时保证足够的物理尺寸

插入到右上角时，要确保二维码的实际物理尺寸不小于1.5x1.5厘米（手机摄像头正常距离可识别的最小尺寸），同时精准计算位置避免超出页面：

from PyPDF2 import PdfReader, PdfWriter
from reportlab.pdfgen import canvas
from reportlab.lib.units import cm

# 读取原PDF
reader = PdfReader("original.pdf")
writer = PdfWriter()
qr_img_path = "high_def_qr.png"
# 设置二维码物理尺寸为1.5厘米（约42.5 PDF点）
qr_physical_size = 1.5 * cm

for page in reader.pages:
    page_w = float(page.mediabox[2])
    page_h = float(page.mediabox[3])
    
    # 创建临时画布绘制二维码
    temp_canvas = canvas.Canvas("temp_qr.pdf", pagesize=(page_w, page_h))
    # 右上角位置：页面宽度 - 二维码宽度，页面高度 - 二维码高度
    temp_canvas.drawImage(
        qr_img_path,
        x=page_w - qr_physical_size,
        y=page_h - qr_physical_size,
        width=qr_physical_size,
        height=qr_physical_size
    )
    temp_canvas.save()
    
    # 合并原页面和二维码画布
    temp_reader = PdfReader("temp_qr.pdf")
    page.merge_page(temp_reader.pages[0])
    writer.add_page(page)

# 保存最终PDF，确保不压缩图像
with open("pdf_with_scannable_qr.pdf", "wb") as out_file:
    writer.write(out_file)

3. 额外优化建议

• 用PNG格式保存二维码：避免JPEG的压缩失真，保证模块边缘清晰
• 保持高对比度：只用黑/白或其他高对比度颜色组合，不要用浅灰、彩色二维码
• 关闭PDF图像压缩：保存最终PDF时，确保阅读器或生成工具不会压缩二维码图像

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