使用Java Apache PDFBox生成PDF模板时灰色边框问题求助

一、修复灰色边框的方法 #

1. 从模板根源解决 #

你用的PDFEscape默认会给表单字段添加灰色边框，直接在工具内修改模板字段：

• 选中目标表单字段，打开「Field Properties」面板
• 找到「Border」选项，将边框样式设为「None」，同时把背景填充设为「No Fill」
• 保存修改后的模板再用PDFBox填充，边框即可消失

2. 通过PDFBox代码强制移除边框 #

如果模板修改无效，可在代码里手动清除字段外观样式，在设置字段值后添加以下处理逻辑：

if (field instanceof PDTextField) {
    PDTextField textField = (PDTextField) field;
    // 设置边框宽度为0
    textField.setBorderWidth(0);
    // 清除边框色与背景色
    textField.setBorderColor(null);
    textField.setFillColor(null);
    // 重置外观使样式生效
    textField.resetAppearance();
}

若不需要表单字段保持可编辑状态，还可以直接扁平化表单，将字段转为静态文本，彻底消除边框：

// 在document.save()之前添加
form.flatten();

二、更直接的纯文本填充PDF方案推荐 #

1. 用iText 7填充模板 #

iText对表单样式的控制更灵活，能轻松移除边框，示例代码片段：

// 加载模板并初始化文档
PdfDocument pdfDoc = new PdfDocument(new PdfReader(templatePath), new PdfWriter(outputStream));
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

// 填充字段值
form.getField("Text1").setValue(String.valueOf(data.getDocumentNumber()));
form.getField("Text2").setValue(String.valueOf(data.getDate()));
form.getField("Text3").setValue(data.getCreatorFirstName() + " " + data.getCreatorLastName());

// 遍历移除所有字段边框
for (PdfFormField field : form.getFormFields().values()) {
    if (field instanceof PdfTextFormField) {
        field.setBorderWidth(0);
        field.setBorderColor(ColorConstants.TRANSPARENT);
    }
}

// 可选：扁平化表单转为静态文本
form.flattenFields();
pdfDoc.close();

2. HTML转PDF（无模板依赖） #

如果模板结构简单，可通过Freemarker生成填充后的HTML，再用Flying Saucer转成PDF：

• 第一步：编写带占位符的HTML模板，用CSS控制文本样式
• 第二步：用Freemarker填充数据生成完整HTML字符串
• 第三步：转换为PDF，示例代码：

ITextRenderer renderer = new ITextRenderer();
renderer.setDocumentFromString(filledHtmlContent);
renderer.layout();
renderer.createPDF(outputStream);

这种方式无需预先制作PDF模板，样式完全通过CSS定义，适配纯文本填充场景。

3. 直接用PDFBox生成PDF #

若模板逻辑简单，可跳过模板环节，直接用PDFBox API绘制文本与布局，完全自定义样式：

PDDocument document = new PDDocument();
PDPage page = new PDPage(PDRectangle.A4);
document.addPage(page);
PDPageContentStream contentStream = new PDPageContentStream(document, page);

// 设置字体与字号
PDFont font = PDType1Font.HELVETICA;
contentStream.setFont(font, 12);

// 绘制文本内容
contentStream.beginText();
contentStream.newLineAtOffset(50, 750);
contentStream.showText("Document Number: " + data.getDocumentNumber());
contentStream.newLineAtOffset(0, -20);
contentStream.showText("Date: " + data.getDate());
contentStream.newLineAtOffset(0, -20);
contentStream.showText("Creator: " + data.getCreatorFirstName() + " " + data.getCreatorLastName());
contentStream.endText();

contentStream.close();
document.save(outputStream);
document.close();

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