iText加载现有PDF添加文本位置异常，求技术解决方案

我有一份简单的2页PDF表单，需要加载该PDF并在对应页面插入个性化文本，供不同下载用户使用。最初计划在第1页指定位置叠加文本，但运行以下代码后，文本却显示在第1页末尾而非指定的顶部位置，恳请排查问题原因：

PdfReader pdfReader = new PdfReader(inputFile); 
PdfStamper pdfStamper = new PdfStamper(pdfReader, new FileOutputStream(outputFile)); 
for(int i=1; i<= pdfReader.getNumberOfPages(); i++){ 
    PdfContentByte content = pdfStamper.getOverContent(i); 
    if (i == 1) { 
        //Text over the existing page 
        BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.WINANSI, BaseFont.EMBEDDED); 
        content.beginText(); 
        content.setFontAndSize(bf, 18); 
        content.showTextAligned(PdfContentByte.ALIGN_LEFT, "This is some text " + i, 0, 0, 0); 
        content.endText(); 
    } 
}

嗨，我来帮你捋清楚这个问题的根源～

核心原因：PDF坐标系的认知偏差 #

你遇到的问题本质是PDF的默认坐标系和你预期的不一样：

• PDF的坐标原点(0,0)是在页面的左下角，而不是我们日常习惯的左上角。你把文本定位在(0,0)，自然就跑到了页面最底部的角落，看起来像是在页面末尾。
• 另外你直接使用固定的0,0坐标，没有结合页面实际尺寸来计算位置，这也会导致文本位置不符合预期。

修正后的代码方案 #

要把文本放到页面顶部，我们需要先获取页面的实际尺寸，再基于这个尺寸计算正确的Y坐标。这里给你调整后的代码：

PdfReader pdfReader = new PdfReader(inputFile); 
PdfStamper pdfStamper = new PdfStamper(pdfReader, new FileOutputStream(outputFile)); 

// 获取第1页的页面尺寸（如果有旋转，建议用getPageSizeWithRotation()）
Rectangle pageSize = pdfReader.getPageSize(1);
float pageHeight = pageSize.getHeight();

for(int i=1; i<= pdfReader.getNumberOfPages(); i++){ 
    PdfContentByte content = pdfStamper.getOverContent(i); 
    if (i == 1) { 
        //Text over the existing page 
        BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.WINANSI, BaseFont.EMBEDDED); 
        content.beginText(); 
        content.setFontAndSize(bf, 18); 
        // 计算顶部位置：距离左边缘20单位，距离顶部20单位
        float xOffset = 20;
        float yOffset = 20;
        content.showTextAligned(PdfContentByte.ALIGN_LEFT, 
                               "This is some text " + i, 
                               xOffset, 
                               pageHeight - yOffset, 
                               0); 
        content.endText(); 
    } 
}

// 务必关闭资源，避免文件损坏或泄漏
pdfStamper.close();
pdfReader.close();

额外注意事项 #

• 一定要记得关闭pdfStamper和pdfReader，这是很容易忽略的细节，却会导致文件无法正常打开或者资源占用问题。
• 如果你的PDF存在页面旋转（比如横向页面），请改用pdfReader.getPageSizeWithRotation(1)来获取正确的页面尺寸，保证坐标计算准确。
• 你可以通过调整xOffset和yOffset的数值，精准控制文本在页面上的位置，完全匹配你的需求。

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