使用PyPDF2添加超链接目录页及页面链接错误问题

一、PyPDF2能否添加带超链接的目录页？ #

PyPDF2本身不支持直接创建带超链接的目录页，它的核心能力集中在PDF合并、拆分、书签管理等操作上。要实现带超链接的目录页，通常需要先借助FPDF、ReportLab这类库生成包含超链接的独立目录PDF，再用PyPDF2将该目录PDF与合并后的目标PDF合并，同时注意调整超链接的页码指向（因为目录页会占用1页，原PDF的页码在合并后会整体后移）。

二、解决FPDF创建目录时的页码报错问题 #

你遇到的ValueError: 第1页存在指向不存在页面3的无效引用错误，原因很明确：你生成的FPDF文档仅包含1页，但却给超链接指定了第3、4页，这些页面在当前单独的目录PDF中根本不存在。

修正思路与示例 #

1. 先明确最终页码结构

假设你已合并好的目标PDF为merged.pdf，总页数为N，那么合并目录后，目录页是第1页，原目标PDF的第1页对应合并后的第2页，第2页对应第3页，以此类推。

2. 动态生成匹配最终页码的目录PDF

先获取目标PDF的总页数，再动态设置超链接的目标页码：

from fpdf import FPDF
from PyPDF2 import PdfReader

# 获取目标PDF的总页数
target_reader = PdfReader("merged.pdf")
total_target_pages = len(target_reader.pages)

# 生成带正确超链接的目录PDF
pdf = FPDF()
pdf.set_font("helvetica", size=12)
pdf.add_page()

for page_num in range(total_target_pages):
    # 原目标PDF的第page_num+1页，对应合并后的第page_num+2页（目录占1页）
    link = pdf.add_link(page=page_num + 2)
    pdf.cell(text=f"第{page_num+1}部分 内容", border=0, link=link, ln=2)

pdf.output("目录.pdf")

3. 合并目录与目标PDF

from PyPDF2 import PdfMerger

merger = PdfMerger()
# 先添加目录，再添加合并好的目标PDF
merger.append("目录.pdf")
merger.append("merged.pdf")
merger.write("带目录的最终文件.pdf")
merger.close()

这样生成的目录超链接会准确指向合并后PDF的对应页面，不会再出现页码不存在的报错。

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