如何通过PDFBox将透明文本适配PDF页面固定位置

方案1：用特殊空白字符填充剩余宽度（避免被阅读器移除） #

PDF阅读器自动删除末尾普通空格是因为标准文本处理规则，你可以用**非断空格（U+00A0）替代普通空格，这类字符不会被自动移除，同时保持文本可搜索性；剩余不足一个空格的宽度，用零宽度空格（U+200B）**补位，不影响视觉但能覆盖目标区域：

PDPageContentStream contentStream = new PDPageContentStream(document, page, PDPageContentStream.AppendMode.APPEND, true, true);
contentStream.setNonStrokingColor(new Color(0, 0, 0, 0)); // 设置文本透明

String text = field.getFieldResult();
PDFont font = PDType1Font.HELVETICA;
float fontSize = ...; // 已计算的适配字号
float targetWidth = x2 - x1;
float textWidth = font.getStringWidth(text) * fontSize / 1000;
float remainingWidth = targetWidth - textWidth;

if (remainingWidth > 0) {
    float spaceWidth = font.getStringWidth("\u00A0") * fontSize / 1000;
    int spaceCount = (int) Math.floor(remainingWidth / spaceWidth);
    
    StringBuilder filledText = new StringBuilder(text);
    for (int i = 0; i < spaceCount; i++) {
        filledText.append("\u00A0");
    }
    // 补零宽度空格覆盖剩余窄缝
    filledText.append("\u200B");
    text = filledText.toString();
}

// 绘制文本到目标位置
contentStream.beginText();
contentStream.setFont(font, fontSize);
contentStream.newLineAtOffset(x1, y1);
contentStream.showText(text);
contentStream.endText();
contentStream.close();

方案2：分段绘制文本与占位空白块 #

如果特殊字符仍有问题，可直接在原文本后，定位绘制由非断空格组成的不可见占位块，精确填充剩余区域：

PDPageContentStream contentStream = new PDPageContentStream(document, page, PDPageContentStream.AppendMode.APPEND, true, true);
contentStream.setNonStrokingColor(new Color(0, 0, 0, 0));

String text = field.getFieldResult();
PDFont font = PDType1Font.HELVETICA;
float fontSize = ...;
float targetWidth = x2 - x1;
float textWidth = font.getStringWidth(text) * fontSize / 1000;
float remainingWidth = targetWidth - textWidth;

// 绘制原文本
contentStream.beginText();
contentStream.setFont(font, fontSize);
contentStream.newLineAtOffset(x1, y1);
contentStream.showText(text);
contentStream.endText();

// 绘制占位空白块
if (remainingWidth > 0) {
    float spaceWidth = font.getStringWidth("\u00A0") * fontSize / 1000;
    int spaceCount = (int) Math.floor(remainingWidth / spaceWidth);
    String filler = new String(new char[spaceCount]).replace('\0', '\u00A0');
    
    contentStream.beginText();
    contentStream.setFont(font, fontSize);
    contentStream.newLineAtOffset(x1 + textWidth, y1);
    contentStream.showText(filler);
    contentStream.endText();
}
contentStream.close();

方案3：绑定表单域适配固定区域（最优复制体验） #

如果场景允许，直接将文本绑定到隐藏表单域，PDF阅读器会自动处理文本对齐与区域覆盖，复制时会选中整个域内容，体验更自然：

// 获取或创建AcroForm
PDAcroForm acroForm = document.getDocumentCatalog().getAcroForm();
if (acroForm == null) {
    acroForm = new PDAcroForm(document);
    document.getDocumentCatalog().setAcroForm(acroForm);
}

// 创建文本域
PDTextField textField = new PDTextField(acroForm);
textField.setPartialName("fixed_pos_text");
textField.setValue(field.getFieldResult());

// 设置域位置与大小
PDRectangle rect = new PDRectangle(x1, y1, x2 - x1, y2 - y1);
PDAnnotationWidget widget = textField.getWidgets().get(0);
widget.setRectangle(rect);

// 设置透明文本样式
PDAppearanceCharacteristicsDictionary appearanceDict = new PDAppearanceCharacteristicsDictionary(new COSDictionary());
widget.setAppearanceCharacteristics(appearanceDict);

PDAppearanceContentStream appearanceStream = new PDAppearanceContentStream(document, widget.getNormalAppearance().getAppearanceStream());
appearanceStream.setNonStrokingColor(new Color(0, 0, 0, 0));
appearanceStream.beginText();
appearanceStream.setFont(font, fontSize);
appearanceStream.newLineAtOffset(rect.getLowerLeftX(), rect.getLowerLeftY());
appearanceStream.showText(textField.getValue());
appearanceStream.endText();
appearanceStream.close();

// 添加到页面
page.getAnnotations().add(widget);

核心提示 #

• 非断空格是关键：既不会被阅读器自动清理，也能保持可搜索属性；
• 表单域方案最符合PDF规范，复制体验远优于纯文本填充；
• 所有方案均保留文本可搜索性，无需牺牲核心需求。

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