如何定位PDF最后一页内容末尾并添加文本块（含分页处理）

假设你用的是Apache PDFBox（毕竟提到了PDDocument），我来分享一套实用的实现思路——核心就是先精准定位最后一页的内容边界，再判断剩余空间能否容纳新文本，最后决定直接追加还是新建页面。

1. 定位最后一页的内容底部边界 #

PDF的坐标系原点在左下角，Y值越大越靠上。要找到现有内容的末尾，我们需要遍历页面内容流，提取所有元素的最大Y坐标（也就是内容最底部的位置）：

PDDocument document = PDDocument.load(new File("your-source.pdf"));
PDPage lastPage = document.getPage(document.getNumberOfPages() - 1);
PDRectangle pageSize = lastPage.getMediaBox();

// 计算当前页面内容的最底部Y坐标
float contentBottom = getContentBottomY(lastPage);
float margin = 20; // 预留页面边距，避免贴边

这里的核心方法getContentBottomY需要解析页面内容流，提取关键坐标：

private static float getContentBottomY(PDPage page) throws IOException {
    // 默认从底部边距开始，避免空页面出错
    float maxY = page.getMediaBox().getLowerLeftY() + margin;
    
    // 遍历页面的所有内容操作，提取Y坐标
    PDStream contents = page.getContents();
    if (contents != null) {
        PDFStreamParser parser = new PDFStreamParser(contents);
        parser.parse();
        List<Object> tokens = parser.getTokens();
        
        for (int i = 0; i < tokens.size(); i++) {
            Object token = tokens.get(i);
            if (token instanceof COSFloat) {
                float val = ((COSFloat) token).floatValue();
                // 匹配文本定位操作符（Td/Tm），提取Y坐标
                if (i < tokens.size() - 1 && tokens.get(i+1) instanceof COSName) {
                    COSName op = (COSName) tokens.get(i+1);
                    if ("Td".equals(op.getName()) || "Tm".equals(op.getName())) {
                        if (val > maxY) maxY = val;
                    }
                }
            }
        }
    }
    return maxY;
}

2. 判断剩余空间是否能容纳新文本 #

接下来要计算你要插入的文本需要的高度，再和剩余空间对比：

// 定义文本样式
PDType0Font font = PDType0Font.load(document, new File("your-font.ttf"));
float fontSize = 12;
float lineHeight = fontSize * 1.2f; // 行高设为字号1.2倍更美观
String textToAdd = "这是你要追加的长文本内容，可能包含多行，需要自动换行适配页面宽度";

// 计算单行最大宽度（页面宽度减去左右边距）
float maxTextWidth = pageSize.getWidth() - 2 * margin;
// 拆分文本为适配宽度的行
List<String> textLines = splitTextToFitWidth(textToAdd, font, fontSize, maxTextWidth);
// 计算文本总高度
float requiredHeight = textLines.size() * lineHeight;

// 剩余可用高度：内容底部到页面底部边距的距离
float availableHeight = contentBottom - margin;

拆分文本的辅助方法：

private static List<String> splitTextToFitWidth(String text, PDType0Font font, float fontSize, float maxWidth) throws IOException {
    List<String> lines = new ArrayList<>();
    StringTokenizer tokenizer = new StringTokenizer(text, " ");
    StringBuilder currentLine = new StringBuilder();
    float currentWidth = 0;

    while (tokenizer.hasMoreTokens()) {
        String word = tokenizer.nextToken();
        float wordWidth = font.getStringWidth(word) / 1000 * fontSize;
        
        if (currentWidth + wordWidth > maxWidth && currentLine.length() > 0) {
            lines.add(currentLine.toString());
            currentLine = new StringBuilder();
            currentWidth = 0;
        }
        
        if (currentLine.length() > 0) {
            currentLine.append(" ");
            currentWidth += font.getStringWidth(" ") / 1000 * fontSize;
        }
        currentLine.append(word);
        currentWidth += wordWidth;
    }
    if (currentLine.length() > 0) lines.add(currentLine.toString());
    return lines;
}

3. 追加文本（自动判断是否新建页面） #

最后根据空间判断结果，执行对应的操作：

if (availableHeight >= requiredHeight) {
    // 空间足够，直接在最后一页追加
    drawTextOnPage(lastPage, textLines, font, fontSize, lineHeight, margin, contentBottom - requiredHeight);
} else {
    // 空间不足，新建页面再添加
    PDPage newPage = new PDPage(pageSize);
    document.addPage(newPage);
    drawTextOnPage(newPage, textLines, font, fontSize, lineHeight, margin, pageSize.getLowerLeftY() + margin);
}

document.save("modified-document.pdf");
document.close();

通用的文本绘制方法：

private static void drawTextOnPage(PDPage page, List<String> lines, PDType0Font font, float fontSize, float lineHeight, float margin, float startY) throws IOException {
    // 以APPEND模式打开内容流，避免覆盖原有内容
    try (PDPageContentStream contentStream = new PDPageContentStream(page, PDPageContentStream.AppendMode.APPEND, true, true)) {
        contentStream.beginText();
        contentStream.setFont(font, fontSize);
        contentStream.newLineAtOffset(margin, startY);
        
        for (String line : lines) {
            contentStream.showText(line);
            contentStream.newLineAtOffset(0, -lineHeight);
        }
        contentStream.endText();
    }
}

额外提示 #

• 如果你的PDF包含表单、图片或复杂布局，getContentBottomY可能需要补充逻辑（比如解析表单字段的位置、图片的Y坐标）；
• 可以直接使用PDFBox内置字体（如PDType1Font.HELVETICA）替代自定义字体，避免路径问题；
• 测试时要覆盖空页面、满内容页面等极端场景，确保逻辑稳定。

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