基于Apache PDFBox 3.0.3，如何获取PDField边框内的可见文本并实现超长文本跨页填充？

我之前做类似需求的时候踩过几个坑，给你梳理下具体的实现步骤，都是基于PDFBox 3.0.3的实操经验：

一、先搞清楚文本字段的「容量参数」 #

PDFBox没有直接提供API告诉你字段能装多少文本，得自己算。首先要拿到字段的三个关键信息：使用的字体、字号、可视区域的宽高。

拿PDTextField举例，代码这么写：

// 先拿到目标文本字段
PDTextField targetField = (PDTextField) acroForm.getField("你的字段名称");
// 解析默认外观字符串（DA），格式一般是 "/Helvetica 12 Tf 0 g" 这种
String defaultAppearance = targetField.getDefaultAppearance();
String[] daSegments = defaultAppearance.split(" ");
// 提取字体（去掉开头的/）
PDFont fieldFont = PDResources.getFont(acroForm.getResources(), daSegments[0].substring(1));
// 提取字号
float fontSize = Float.parseFloat(daSegments[1]);

// 获取字段的可视边界框
PDRectangle fieldRect = targetField.getWidgets().get(0).getRectangle();
float usableWidth = fieldRect.getWidth() - 4; // 留4个单位的内边距，避免文本贴边框
int maxVisibleLines = 9; // 你提到的字段能显示9行，直接用这个数值就行

二、把长文本拆分成「可容纳的段落」 #

接下来要把超长文本拆成第一页能放下的部分，剩下的留到新页面。这里最好按单词拆分，别硬切字符导致单词断裂，写个小工具方法搞定：

private static List<String> splitTextIntoFitLines(String longText, PDFont font, float fontSize, float maxLineWidth) throws IOException {
    List<String> fitLines = new ArrayList<>();
    String[] words = longText.split(" ");
    StringBuilder currentLine = new StringBuilder();

    for (String word : words) {
        // 测试当前行加这个单词后的宽度
        String testLine = currentLine.length() > 0 ? currentLine + " " + word : word;
        // PDFBox的getStringWidth返回的是1/1000单位的宽度，要转成实际像素宽度
        float lineWidth = font.getStringWidth(testLine) * fontSize / 1000;

        if (lineWidth <= maxLineWidth) {
            currentLine.append(currentLine.length() > 0 ? " " : "").append(word);
        } else {
            // 加不下了，把当前行存入列表，重新开始一行
            fitLines.add(currentLine.toString());
            currentLine = new StringBuilder(word);
        }
    }
    // 把最后一行加进去
    if (currentLine.length() > 0) {
        fitLines.add(currentLine.toString());
    }
    return fitLines;
}

然后用这个方法拆分文本，分离出第一页和剩余内容：

List<String> allLines = splitTextIntoFitLines(你的长文本, fieldFont, fontSize, usableWidth);
// 第一页要显示的内容：取前9行，用换行符拼接
String firstPageContent = String.join("\n", allLines.subList(0, Math.min(maxVisibleLines, allLines.size())));
// 剩余要放到新页面的内容
String remainingContent = "";
if (allLines.size() > maxVisibleLines) {
    remainingContent = String.join("\n", allLines.subList(maxVisibleLines, allLines.size()));
}

三、填充字段并处理跨页 #

先把第一页的内容填入原字段：

targetField.setValue(firstPageContent);
targetField.setMultiline(true); // 确保字段是多行模式（如果之前没设的话）

如果有剩余内容，就复制页面并填充新字段：

if (!remainingContent.isEmpty()) {
    PDDocument doc = ...; // 你的文档对象
    PDPage originalPage = doc.getPage(0); // 假设原页面是第0页，根据实际情况调整
    // 复制原页面
    PDPage newPage = new PDPage(originalPage.getMediaBox());
    doc.addPage(newPage);

    // 复制原字段的样式到新页面的字段（关键：不然新页面的字段显示不对）
    PDAnnotationWidget originalWidget = targetField.getWidgets().get(0);
    PDAnnotationWidget newWidget = new PDAnnotationWidget(originalWidget.getCOSObject());
    newWidget.setRectangle(originalWidget.getRectangle()); // 和原字段位置一致
    newPage.getAnnotations().add(newWidget);

    // 创建新的文本字段并关联到新页面
    PDTextField newField = new PDTextField(acroForm);
    newField.setPartialName(targetField.getPartialName() + "_page2"); // 给个新名字避免冲突
    newField.setMultiline(true);
    newField.setDefaultAppearance(targetField.getDefaultAppearance()); // 复用原字段的外观
    newField.getWidgets().add(newWidget);
    acroForm.getFields().add(newField);

    // 填充剩余文本
    newField.setValue(remainingContent);
}

一些要注意的小细节 #

• 如果你的文本里本身有换行符，记得先预处理（比如替换成空格），不然拆分逻辑会乱；
• 计算可用宽度的时候，内边距可以根据实际字段的样式调整，不一定是4；
• 复制页面时，如果原页面有其他元素，要确保新页面完整复制了原页面的内容（如果你的复制逻辑已经搞定这部分就不用管）。

备注：内容来源于stack exchange，提问作者felixschoene