如何在Java中获取PDF文件的页眉、页脚及侧边留白尺寸？

当然可以搞定这个需求！你已经摸到了关键——MediaBox和CropBox就是计算页眉、页脚及侧边留白的核心依据，只是需要搞清楚它们的关系和计算逻辑就行。

先搞懂两个盒子的含义 #

• MediaBox：PDF页面的「原始画布尺寸」，相当于页面的最大物理边界，所有内容都在这个范围内绘制。
• CropBox：PDF实际显示/打印时的「可见区域」，留白就是MediaBox超出CropBox的部分——简单说，留白尺寸 = MediaBox边界与CropBox边界的差值。

计算逻辑（重点！） #

PDF的坐标系原点在页面左下角，x轴向右递增，y轴向上递增。所以各边留白的计算公式如下（单位默认是点（pt））：

• 左侧留白：CropBox.getLeft() - MediaBox.getLeft()
• 右侧留白：MediaBox.getRight() - CropBox.getRight()
• 底部留白（页脚区域）：CropBox.getBottom() - MediaBox.getBottom()
• 顶部留白（页眉区域）：MediaBox.getTop() - CropBox.getTop()

如果需要转换成你要的px单位，记住这个转换关系：1pt ≈ 1.333px（因为PDF用72dpi，屏幕通常是96dpi，换算公式是 px值 = pt值 / 0.75）。

完整代码示例（基于iText 7） #

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfPage;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.geom.Rectangle;

import java.io.IOException;

public class PdfMarginCalculator {
    public static void main(String[] args) throws IOException {
        String pdfFilePath = "your-target-file.pdf";
        
        // 自动关闭资源的try-with-resources语法
        try (PdfReader reader = new PdfReader(pdfFilePath);
             PdfDocument pdfDoc = new PdfDocument(reader)) {
            
            // 获取第一页（如果需要遍历所有页，用for循环遍历pdfDoc.getNumberOfPages()即可）
            PdfPage firstPage = pdfDoc.getPage(1);
            Rectangle mediaBox = firstPage.getMediaBox();
            Rectangle cropBox = firstPage.getCropBox();
            
            // 处理CropBox未设置的情况：默认等于MediaBox，即无刻意留白
            if (cropBox == null) {
                cropBox = mediaBox;
            }
            
            // 计算各边留白（pt单位）
            float leftMarginPt = cropBox.getLeft() - mediaBox.getLeft();
            float rightMarginPt = mediaBox.getRight() - cropBox.getRight();
            float bottomMarginPt = cropBox.getBottom() - mediaBox.getBottom();
            float topMarginPt = mediaBox.getTop() - cropBox.getTop();
            
            // 转换为px单位
            float leftMarginPx = leftMarginPt / 0.75f;
            float rightMarginPx = rightMarginPt / 0.75f;
            float bottomMarginPx = bottomMarginPt / 0.75f;
            float topMarginPx = topMarginPt / 0.75f;
            
            // 格式化输出结果
            System.out.printf("左侧留白：%.2fpx%n", leftMarginPx);
            System.out.printf("右侧留白：%.2fpx%n", rightMarginPx);
            System.out.printf("页脚（底部）留白：%.2fpx%n", bottomMarginPx);
            System.out.printf("页眉（顶部）留白：%.2fpx%n", topMarginPx);
        }
    }
}

几个注意事项 #

• 如果你用的是iText 5（旧版），API略有不同：比如用PdfReader.getPageSize(int pageNum)获取MediaBox，PdfReader.getCropBox(int pageNum)获取CropBox，计算逻辑完全一致。
• 部分PDF可能没有设置CropBox，此时默认和MediaBox重合，意味着没有手动设置的留白。
• 如果需要更精准的打印级留白，可以考虑用TrimBox（成品裁切后的区域），但大部分场景下CropBox足以满足需求。

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