本文详解如何利用 openpdf 的 `pdfstamper` 与页面覆层（overcontent）机制，将印章等图像精确叠加在 pdf 文本上方，支持动态坐标、跨页适配与合同场景下的灵活盖章需求。
在 OpenPDF（iText 2.x 的开源分支）中，Image 类原生仅提供 UNDERLYING（底层）、TEXTWRAP（图文混排）等有限布局模式，不支持“浮于文字之上”的图层语义——这是因为 Document.add(Image) 始终将图像作为内容流的一部分插入，受段落流式布局约束，无法突破当前文本层的 Z 轴顺序。
真正的解决方案在于跳出“流式添加”思维，转而采用 PDF 编辑级操作：使用 PdfStamper 操作页面覆层（OverContent）。覆层（getOverContent(pageNumber)）是 PDF 规范定义的独立图形层，始终渲染在页面所有内容（包括原始文本、表格、图表）之上，天然满足“印章盖在合同文字上”的核心需求。
✅ 正确实现步骤
- 基于现有 PDF 创建 PdfStamper（不可用 Document 新建）
- 获取目标页的 PdfContentByte 覆层对象
- 通过 addImage() 方法以绝对坐标（x, y）添加图像
- 注意坐标系原点：左下角（PDF 默认），y 值需根据页面高度换算
以下为完整示例代码（含动态位置计算与异常处理）：
import com.lowagie.text.Image;
import com.lowagie.text.pdf.PdfContentByte;
import com.lowagie.text.pdf.PdfReader;
import com.lowagie.text.pdf.PdfStamper;
import java.io.FileOutputStream;
import java.io.IOException;
public class SealOverlayExample {
public static void addSealToPage(String srcPdf, String destPdf, String sealImagePath,
float x, float y, int pageNumber) throws IOException {
PdfReader reader = new PdfReader(srcPdf);
try (PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(destPdf))) {
// 获取指定页的覆层（OverContent），确保图像显示在最上层
PdfContentByte overContent = stamper.getOverContent(pageNumber);
// 加载印章图像（支持 PNG 透明通道）
Image seal = Image.getInstance(sealImagePath);
seal.scalePercent(75); // 可选：按比例缩放，避免过大
// 设置绝对位置：PDF 坐标系原点为左下角
// 若需“距右上角 50pt”，可计算：x = pageSize.getWidth() - seal.getScaledWidth() - 50;
seal.setAbsolutePosition(x, y);
// 将图像绘制到覆层
overContent.addImage(seal);
}
}
// 示例：在第 1 页右下角添加印章（距右 80pt，距底 60pt）
public static void main(String[] args) throws Exception {
PdfReader reader = new PdfReader("contract.pdf");
float pageHeight = reader.getPageSize(1).getHeight();
float pageWidth = reader.getPageSize(1).getWidth();
// 计算右下角偏移坐标（x 从左起，y 从下起）
float x = pageWidth - 120; // 宽度预留 120pt（含印章自身宽度）
float y = 60; // 距底部 60pt
addSealToPage("contract.pdf", "contract_sealed.pdf", "seal.png", x, y, 1);
System.out.println("✅ 印章已成功叠加至第 1 页右下角。");
}
}⚠️ 关键注意事项
- getOverContent() vs getUnderContent()：务必使用 getOverContent()；getUnderContent() 会将图像置于原文本之下，导致被遮挡。
- 坐标动态性：合同文本长度变化可能影响页码与元素位置。建议结合 ColumnText 或 PdfReader.getPageN() 提取文本区域边界，再按逻辑偏移计算 x/y（例如“签字行下方 20pt，居中”）。
- 透明背景支持：PNG 格式印章需保留 Alpha 通道，OpenPDF 默认支持；若出现黑底，请检查图像是否含正确透明信息。
- 分页处理：pageNumber 从 1 开始计数；多页盖章需循环调用，并校验 reader.getNumberOfPages()。
- 性能提示：PdfStamper 适合编辑已有 PDF；若需从零生成带浮动印章的文档，应先用 Document 输出基础内容，再用 PdfStamper 后期叠加印章——无纯流式替代方案。
✅ 总结
OpenPDF 中实现“文字上浮印章”，本质是 PDF 图层操作而非文本布局问题。放弃对 Image 流式定位属性的依赖，转向 PdfStamper#getOverContent() + 绝对坐标绘图，即可稳定、精准、高效地完成合同盖章、水印添加、动态批注等生产级需求。该方案完全兼容 OpenPDF 1.3+，且与 iText 2.x 生态无缝衔接。
