使用PDFBox向已有PDF文件追加页面时内容被覆盖的问题求助

看起来你是用Apache PDFBox操作PDF时踩了个常见的坑——你混淆了向已有页面追加内容和添加全新页面到文档末尾这两个操作：用APPEND模式的PDPageContentStream是用来在现有页面的内容后面继续绘制，而不是帮你创建新页面追加到文档最后。

下面给你一步步梳理正确的实现思路：

1. 正确加载现有文档并创建新页面 #

首先确保你正确加载了目标PDF，然后创建全新的PDPage对象，把它添加到文档的页面列表末尾——这一步才是真正实现「追加新页」：

// 加载现有PDF文档
PDDocument document = PDDocument.load(new File("existing.pdf"));

// 可以选择和现有页面一致的尺寸创建新页
PDPage newPage = new PDPage(document.getPage(0).getMediaBox());
document.addPage(newPage); // 这一步将新页面追加到文档末尾

2. 在新页面上创建内容流 #

接下来要针对刚创建的新页面生成PDPageContentStream，新页面本身是空的，不需要用APPEND模式：

// 针对新页面创建内容流
PDPageContentStream contentStream = new PDPageContentStream(document, newPage);

// 在这里添加你需要的内容，比如插入图片
PDImageXObject image = PDImageXObject.createFromFile("new-image.jpg", document);
contentStream.drawImage(image, 100, 100); // 自定义坐标和尺寸

// 操作完成后关闭流
contentStream.close();

3. 保存并关闭文档 #

最后别忘了保存修改并关闭文档，确保所有操作生效：

document.save("updated.pdf");
document.close();

为什么你的原有方法会出现覆盖？ #

你之前用APPEND模式操作的是已存在的最后一页，而不是新页面——APPEND模式的作用是让你在该页面原有内容的后方添加新内容，但如果代码逻辑有误（比如误操作了原有页面的内容流），就会出现内容被覆盖的错觉。核心是要明确区分「给旧页补内容」和「加全新页面」这两个不同需求对应的操作。

如果你的实际需求是给最后一页追加内容而非添加新页，那才需要用到APPEND模式，示例代码如下：

PDPage lastPage = document.getPage(document.getNumberOfPages() - 1);
// 用APPEND模式打开最后一页的内容流
PDPageContentStream contentStream = new PDPageContentStream(document, lastPage, PDPageContentStream.AppendMode.APPEND, true);
// 在这里添加内容到最后一页
contentStream.close();

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