使用iText的PdfStamper创建书签遇阻，求无需重开文件的解决方案

你遇到的问题很典型——PdfStamper.getWriter().getRootOutline()返回null，是因为原有PDF本身没有大纲，而且stamper的Writer不会自动初始化根大纲节点。直接操作Reader的设置也没用，因为大纲的修改需要通过PdfStamper的API来完成，不用重新创建PdfWriter实例，完全可以基于现有stamper和reader实现。

核心思路 #

1. 先检查现有PDF是否有大纲：通过stamper.getWriter().getRootOutline()获取，null就说明没有，需要手动创建根大纲
2. 用PdfOutline类创建各级大纲条目，关联到stamper的Writer和目标页面
3. 设置视图偏好让PDF打开时自动显示大纲（可选，但提升体验）

修改后的完整代码 #

PdfReader reader = new PdfReader(srcPdf); 
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(outputPdf));

// 1. 获取或初始化根大纲
PdfOutline rootOutline = stamper.getWriter().getRootOutline();
if (rootOutline == null) {
    // 如果原有PDF无大纲，创建根节点（名称可以自定义，空字符串则不显示根条目）
    rootOutline = new PdfOutline(null, stamper.getWriter().getDirectContent(), "文档大纲");
}

// 2. 添加一级大纲：指向第1页，适配页面大小
PdfOutline section1 = new PdfOutline(
    rootOutline,
    PdfAction.gotoLocalPage(1, new PdfDestination(PdfDestination.FIT), stamper.getWriter()),
    "第一部分：基础介绍"
);

// 3. 添加子大纲：指向第1页的特定位置（X=0, Y=600，缩放比例1.0）
new PdfOutline(
    section1,
    PdfAction.gotoLocalPage(1, new PdfDestination(PdfDestination.XYZ, 0, 600, 1.0f), stamper.getWriter()),
    "1.1 核心概念"
);

// 4. 设置PDF打开时自动显示大纲（可选）
stamper.setViewerPreferences(PdfWriter.PageModeUseOutlines);

// 收尾操作
stamper.close();
reader.close();

关键细节说明 #

• 为什么getRootOutline()是null？：如果原PDF没有任何大纲，stamper的Writer不会自动生成根节点，必须手动创建。如果原PDF已有大纲，这个方法会返回现有根节点，你可以直接在下面添加新条目。
• PdfDestination的用法：除了FIT（适配页面），还可以用XYZ指定具体坐标和缩放，FITB（适配内容）等，根据需求选择。
• 无需重新创建文件：整个流程基于你已有的reader和stamper实例，不需要改用PdfWriter重新生成PDF，完全符合你的需求。

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