iTextPDF 5合并PDF后生成的TOC超链接跳转位置错误问题求助

核心原因 #

• 跳转视图规则缺失：超链接使用命名目的地创建跳转动作时，未显式指定页面视图适配规则，默认定位逻辑偏移到了页面底部区域。而书签代码显式指定了Fit（整页适配视口）规则，会自动定位到目标页顶部，因此跳转正常。
• 命名目的地未注册：你并未为合并后的每一页显式注册名为p + 页号的命名目的地，gotoLocalPage方法无法匹配到正确的目标位置，导致跳转出现跨页偏移。

解决方法 #

提供两种可直接落地的实现方案：

方案1：显式指定Fit视图跳转（推荐，和书签订位逻辑完全一致） #

直接替换原有超链接动作的创建逻辑，和书签一样使用页号+Fit视图的配置，无需依赖命名目的地：

// 定义整页适配的跳转目标
PdfDestination dest = new PdfDestination(PdfDestination.FIT);
// entry.getKey()为目标页号，和书签订义的页号保持一致即可
action = PdfAction.gotoLocalPage(entry.getKey(), dest, copydoc);
// 后续注释创建逻辑保持不变
link = new PdfAnnotation(copydoc, 36, ct.getYLine(), 559, y, action);
stamp.addAnnotation(link);

方案2：注册对应命名目的地 #

如果业务需要保留命名目的地的跳转方式，可在合并每一页时主动注册命名目标：

// 合并第pageNum页后添加如下代码，pageNum为合并后PDF的实际页号（从1开始计数）
copydoc.addNamedDestination("p" + pageNum, pageNum, new PdfDestination(PdfDestination.FIT));

注册完成后原有超链接代码即可正常工作。

注意事项 #

• iText框架的PDF页号从1开始计数，需确保entry.getKey()的值和合并后的PDF实际页号、书签使用的页号三者完全一致。
• 若合并的源PDF自带命名目的地，需调用PdfCopy的命名目的地重映射接口避免冲突，防止跳转逻辑异常。

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