本文详解 itext7 在 do/while 循环中重复创建 pdf 时出现 “pdf indirect object belongs to other pdf document” 异常的根本原因与标准解决方案，强调资源隔离、字体复用安全及文档生命周期管理。
本文详解 itext7 在 do/while 循环中重复创建 pdf 时出现 “pdf indirect object belongs to other pdf document” 异常的根本原因与标准解决方案，强调资源隔离、字体复用安全及文档生命周期管理。
在使用 iText7 批量生成多个 PDF 文件时，若在单个 JVM 实例中通过循环反复调用 PDF 创建逻辑，极易触发 PdfException: Pdf indirect object belongs to other PDF document。该异常并非源于 PDF 内容本身，而是由于 跨文档复用了未正确归属当前 PDF 的间接对象（如字体、样式、图像等） —— 尤其常见于静态字段缓存的 PdfFont 或 Style 对象被多个 PdfDocument 实例共享。
根本原因分析
iText7 中，PdfFont、PdfObject 等资源在创建时会绑定到其所属的 PdfDocument 实例。若将一个在 Document A 中创建的 PdfFont（例如通过 PdfFontFactory.createFont(...)）直接用于 Document B，iText 会拒绝写入，因为该字体的底层字典已注册在 Document A 的上下文中。你原始代码中将 Formatter.small/mid/large/lambda 声明为静态字段，并在首次运行后复用——这正是导致第二次循环崩溃的核心：这些 Style 对象内部持有的 PdfFont 仍指向前一个已关闭（或未清理）的 PdfDocument。
正确实践：每次循环独立初始化资源
必须确保每次 PDF 生成周期完全独立：新建 PdfWriter、PdfDocument、Document，且所有依赖资源（字体、样式、表格、图片）均在此周期内创建，禁止跨周期复用静态字体或样式对象。
✅ 推荐写法（关键点已加注释）：
public static void format(String[] GDP, List<list>>> records, String[] results, int runs, int loops) throws IOException {
// ✅ 每次调用都生成新文件名（确保不覆盖）
String fileName = FileNamer();
File file = new File("C:\Users", fileName);
// ✅ 全新实例：Writer → Document → Layout Document
PdfWriter writer = new PdfWriter(file);
PdfDocument pdfDoc = new PdfDocument(writer);
Document document = new Document(pdfDoc);
// ✅ 字体必须在此 Document 上下文中创建（非静态复用！）
PdfFont courier = PdfFontFactory.createFont(StandardFonts.COURIER);
PdfFont symbol = PdfFontFactory.createFont(StandardFonts.SYMBOL);
// ✅ 样式对象也需在此作用域内新建（避免持有旧字体引用）
Style small = new Style().setFont(courier).setFontSize(8f);
Style mid = new Style().setFont(courier).setFontSize(10f);
Style large = new Style().setFont(courier).setFontSize(12f);
Style lambda = new Style().setFont(symbol);
// ✅ 使用样式构建内容（示例：添加带样式的段落）
document.add(new Paragraph("Hemolysis Report").addStyle(large));
document.add(new Paragraph("λ symbol test").addStyle(lambda));
// ✅ 严格按顺序关闭：Document → PdfDocument → PdfWriter（自动触发 flush）
document.close(); // 这会隐式调用 pdfDoc.close() 和 writer.close()
}</list>
⚠️ 关键注意事项
- 禁止静态字体/样式字段：删除所有类似 private static PdfFont courier; 或 public static Style small; 的声明。字体和样式必须是方法局部变量。
- 不要提前创建 Document 数组：如原代码中 Document[] ListOfDocs = {...} 是无效设计——每个 Document 必须绑定唯一 PdfDocument，而 PdfDocument 不可复用。
- 关闭顺序不可颠倒：务必先调用 document.close()，它会自动完成 PdfDocument 和 PdfWriter 的清理；手动调用 pdfDoc.close() 可能引发竞态。
-
异常处理建议：在 try-with-resources 中封装更安全（iText7.2+ 支持）：
try (PdfWriter writer = new PdfWriter(file); PdfDocument pdfDoc = new PdfDocument(writer); Document document = new Document(pdfDoc)) { // 构建逻辑... } // 自动关闭所有资源
总结
该异常本质是 iText7 的资源所有权校验机制在保护 PDF 结构完整性。解决的关键在于 “一次循环，一套全新资源” —— 摒弃全局静态缓存，拥抱局部作用域初始化。遵循此原则，即可稳定支持任意次数的 PDF 批量生成，且输出文件完全符合 ISO 32000 标准，Acrobat 等阅读器可正常打开。
