Apache PdfBox多行内容写入PDF时被覆盖的问题求助

核心问题 #

contentStream.newLine() 多数情况下仅重置文本的x坐标到左边界，不会自动向下偏移足够的y坐标，导致新行与旧行重叠。你需要手动控制文本的垂直位置偏移，或使用封装的段落组件自动处理换行逻辑。

修正方案（以常用的iText 7为例） #

方案1：使用Paragraph组件（推荐）

直接用官方封装的段落类，自动处理换行、行间距，无需手动计算坐标：

// 初始化文档和页面
PdfDocument pdfDoc = new PdfDocument(new PdfWriter("output.pdf"));
Document doc = new Document(pdfDoc);

// 添加多行文本，自动避免重叠
doc.add(new Paragraph("第一行内容"));
doc.add(new Paragraph("第二行内容"));
doc.add(new Paragraph("第三行内容"));

// 关闭文档
doc.close();
pdfDoc.close();

还可通过setMultipliedLeading()自定义行间距：

doc.add(new Paragraph("带自定义行间距的文本").setMultipliedLeading(1.5f));

方案2：手动控制y坐标（若需直接操作画布）

如果坚持用PdfCanvas（contentStream），每次绘制文本后需手动调整y坐标（PDF坐标系y轴向上为正，向下偏移需减少数值）：

PdfDocument pdfDoc = new PdfDocument(new PdfWriter("output.pdf"));
PdfPage page = pdfDoc.addNewPage();
PdfCanvas canvas = new PdfCanvas(page);

float y = 750; // 初始y坐标（页面顶部下方50单位）
float lineHeight = 20; // 行高，根据字体大小调整
PdfFont font = PdfFontFactory.createFont(StandardFonts.HELVETICA);

// 绘制第一行
canvas.beginText()
      .setFontAndSize(font, 12)
      .moveText(50, y)
      .showText("第一行内容")
      .endText();

// 下移y坐标，绘制第二行
y -= lineHeight;
canvas.beginText()
      .setFontAndSize(font, 12)
      .moveText(50, y)
      .showText("第二行内容")
      .endText();

// 重复操作绘制更多行
y -= lineHeight;
canvas.beginText()
      .setFontAndSize(font, 12)
      .moveText(50, y)
      .showText("第三行内容")
      .endText();

pdfDoc.close();

关键注意点 #

• 不要依赖newLine()实现垂直换行，它仅负责水平位置重置。
• 若使用其他PDF库（如Apache PDFBox），逻辑一致：优先用封装的文本组件，或手动计算并调整垂直坐标。

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