iText7 Java生成PDF/A调用close方法报已刷新PDF目录错误咨询

Cannot close document with already flushed PDF Catalog. 报错的核心逻辑是：执行文档关闭操作时，PDF的核心根对象Catalog（文档目录，存储全局配置、页面树、元数据、合规标记等所有顶层信息）已经被提前刷新写入输出流并释放内存，iText无法完成关闭阶段的收尾写入流程，因此抛出异常。

结合给出的代码场景，该问题基本都是操作顺序不符合PDF/A模式的生命周期要求导致的：
使用PdfADocument生成PDF/A-1A合规文档时，所有针对Catalog的全局配置必须在写入任何页面内容之前完成。如果在配置完Catalog参数前就开始写入页面内容，iText的内存自动清理机制会在页面内容积累到阈值时，提前将未完成最终配置的Catalog对象刷入输出流释放。等最终调用close方法要写入收尾的标签结构、合规校验信息、元数据时，Catalog已经被释放，就会触发该报错。
其他常见触发场景：

• 代码中手动调用了pdfDocument.getCatalog().flush()类方法，提前释放了Catalog对象
• 存在重复关闭逻辑：在流程中已经调用过一次close方法完成了Catalog写入释放，后续统一关闭逻辑再次调用close方法
• 初始化流对象后没有做异常兜底，中间写入内容报错时流被异常关闭，后续finally块里再次执行关闭操作也会触发该错
• 提到的colose是拼写笔误，会直接导致编译失败，不是运行时报错的诱因

按优先级排查调整即可：

• 调整代码执行顺序，所有全局配置全部前置到页面内容写入之前
  所有针对Catalog、文档信息、标签配置、字体创建的操作，全部放在添加第一页内容之前完成，参考调整后的初始化逻辑：

  // 第一步：初始化输出流
  pdfWriter = new PdfWriter(this.path_documento + this.nome_documento);
  // 初始化输出意图，不需要传外部色彩配置地址，本地icc文件加载正确即可
  PdfOutputIntent pdfOutputIntent = new PdfOutputIntent("Custom", "", null,"sRGB2014", 
      new FileInputStream("C:\\Users\\UC9001309\\Documents\\NetBeansProjects\\GestionePdf\\sRGB2014.icc") );
  // 第二步：初始化PdfADocument，立刻完成所有全局配置
  pdfDocument = new PdfADocument(pdfWriter, PdfAConformanceLevel.PDF_A_1A, pdfOutputIntent);
  pdfDocument.setTagged();
  pdfDocument.getCatalog().setLang(new PdfString("it-IT")); 
  pdfDocument.getCatalog().setViewerPreferences(new PdfViewerPreferences().setDisplayDocTitle(true));
  PdfDocumentInfo info = pdfDocument.getDocumentInfo();
  info.setTitle("Pdf generato da GestPdf");
  // 第三步：初始化Document、创建字体
  document = new Document(pdfDocument);  
  PdfFont font = PdfFontFactory.createFont(StandardFonts.COURIER_BOLD);
  // 所有初始化完成后，再执行添加2页内容的逻辑
  

• 调整PdfWriter的刷新策略，避免提前刷入未完成配置的核心对象
  初始化PdfWriter时开启智能模式，关闭不必要的自动刷新，让iText只刷新已经完全处理完成的对象：

  pdfWriter = new PdfWriter(this.path_documento + this.nome_documento)
      .setSmartMode(true)
      .setAutoFlush(false);
  

• 排查关闭逻辑，保证文档只关闭一次
  梳理所有调用close方法的分支，避免重复关闭；增加异常捕获逻辑，写入过程中如果报错，直接在catch块里做流关闭处理，不要让流在异常状态下走到后续的重复关闭逻辑。
• 非必要不手动调用核心对象的flush方法
  不要主动调用Catalog、DocumentInfo、结构树这类全局核心对象的flush方法，这类对象会在文档close阶段由iText统一写入处理，手动提前刷新必然会导致关闭流程异常。

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