如何用Python在PDF第一页左上角添加带可点击超链接的图片（解决ReportLab+PyPDF2坐标偏移问题）

这个问题我之前帮人排查过，核心原因是你硬编码了letter页面尺寸来创建overlay，但原PDF的实际页面大小可能和这个不一致，导致两个页面的坐标系统错位，图片就跑到了错误的位置。另外，ReportLab的Y轴是从下往上递增的，坐标计算必须贴合原页面的真实高度，不能用固定值。

下面是修正后的完整解决方案，包含关键改进点和代码：

关键改进说明 #

1. 获取原页面的真实尺寸：不再假设页面是letter大小，而是从原PDF第一页读取mediabox（PDF标准的实际页面边界）的宽高，这是最可靠的页面尺寸数据。
2. 动态创建匹配的Overlay：用原页面的真实尺寸创建ReportLab Canvas，确保overlay和原页面的坐标系统完全对齐，不会出现错位。
3. 精准计算坐标：基于原页面高度计算图片左下角的Y位置（因为ReportLab的Y轴从下往上数），这样图片的顶部会刚好在页面上边缘减去你设置的padding的位置。
4. 验证合并逻辑：由于overlay和原页面尺寸完全一致，merge_page会精准地把图片和链接叠加到预期位置。

修正后的完整代码 #

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

# 配置参数，可根据需求调整
pdf_path = "original.pdf"
icon_path = "icon.jpeg"
output_pdf_path = "output.pdf"
target_url = "https://t.me/newsmalayalampdf"
padding = 40  # 图片与页面边缘的距离
image_size = inch  # 图片的宽高，这里用1英寸

# 第一步：读取原PDF并获取第一页的真实尺寸
reader = PdfReader(pdf_path)
first_page = reader.pages[0]

# 获取页面实际宽高（mediabox是PDF的标准页面边界，比cropbox更可靠）
page_width = float(first_page.mediabox.width)
page_height = float(first_page.mediabox.height)

# 第二步：创建与原页面尺寸完全匹配的Overlay Canvas
packet = io.BytesIO()
# 用原页面的宽高作为Canvas的页面尺寸，确保坐标系统对齐
can = canvas.Canvas(packet, pagesize=(page_width, page_height))

# 第三步：计算左上角的精准坐标
x = padding  # 图片左下角的X坐标（左边距）
# 图片左下角的Y坐标：页面高度 - 上边距 - 图片高度（Y轴从下往上递增）
y = page_height - padding - image_size

# 绘制图片，preserveAspectRatio=True可以避免图片拉伸变形
can.drawImage(icon_path, x, y, width=image_size, height=image_size, preserveAspectRatio=True)
# 添加超链接，链接区域和图片区域完全重合
can.linkURL(target_url, (x, y, x + image_size, y + image_size), relative=0)

# 保存Overlay并重置指针到开头
can.save()
packet.seek(0)

# 第四步：合并Overlay与原PDF
overlay_reader = PdfReader(packet)
overlay_page = overlay_reader.pages[0]

# 合并第一页：因为尺寸完全匹配，内容会精准叠加
first_page.merge_page(overlay_page)

# 生成输出PDF
writer = PdfWriter()
writer.add_page(first_page)
# 添加原PDF的剩余页面
for page in reader.pages[1:]:
    writer.add_page(page)

with open(output_pdf_path, "wb") as f:
    writer.write(f)

额外调试技巧 #

如果你还是遇到位置问题，可以加个调试用的红色边框，直观看到链接区域的位置：

# 在绘制图片后添加这段代码，显示图片的边界（调试用）
can.setStrokeColorRGB(1, 0, 0)  # 红色
can.rect(x, y, image_size, image_size)  # 绘制矩形边框

另外，如果原页面有旋转（比如first_page.rotation != 0），需要先把页面旋转回正常方向再处理，合并后再旋转回去，否则坐标会错位。

为什么你的原代码会失效？ #

你的代码固定用letter页面大小创建Overlay，但如果原PDF是A4、自定义尺寸甚至是旋转过的页面，那么Overlay的坐标系统和原页面完全不匹配，合并后图片就会跑到错误的位置。即使原页面是letter，某些PDF可能有不同的cropbox（显示边界），但mediabox是最可靠的实际页面尺寸。

内容来源于stack exchange