PDFbox提示PDDocument已关闭但实际未关闭的表单填充问题

先明确下你的场景：

用PDFBox填充重复表单，用TreeMap存储记录逐条填充，规则是第一页显示6条记录，条目超6条时插入静态页再继续填充下一组6条；现在条目数超过35条时，会出现类似Apr 23, 201...的截断日期警告，找不到原因。

可能的触发原因 #

结合PDFBox的表单填充逻辑和你的场景，这个警告大概率和以下几点有关：

• 日期字段格式冲突：PDF表单的日期字段通常要求特定格式（比如D:YYYYMMDDHHmmSS），如果TreeMap里某条记录的日期是Apr 23, 2024这类文本格式，填充时PDFBox无法解析，就会抛出格式警告；刚好第36条（也就是第6组第一条）的日期数据踩中了这个问题。
• 页面克隆的字段重复/资源泄漏：如果插入静态页或复用表单页时，没正确克隆字段而是直接引用旧页面的字段，当循环到第6次（35条是5组+5条，第36条是第6组），字段名重复或者资源累积导致PDFBox解析字段值时出错，表现为日期相关警告。
• TreeMap遍历的特殊条目：TreeMap是有序遍历，可能第36条记录的日期字段为空、格式异常，刚好触发了PDFBox的日志警告。
• 旧版本PDFBox的bug：部分2.0.x早期版本的PDFBox在处理大量重复表单字段时，对日期类型字段的处理存在兼容性问题，条目数达到一定阈值就会触发警告。

排查与解决步骤 #

1. 先抓完整警告日志
   把PDFBox的日志级别调到DEBUG，看完整的警告信息，确认是哪个字段、哪个页面触发的。可以加这段代码开启详细日志：

   org.apache.commons.logging.LogFactory.getLog("org.apache.pdfbox").setLevel(org.apache.commons.logging.Level.DEBUG);
   

   完整日志会告诉你具体是哪个字段解析失败，直接定位问题点。

2. 检查第36条记录的日期数据
   打印TreeMap里第36条（索引从0算的话是第35个）的所有字段值，重点看日期字段的格式和内容，是不是为空、格式不符合表单要求。如果是格式问题，转成PDF标准日期格式再填充：

   SimpleDateFormat pdfDateFormat = new SimpleDateFormat("D:yyyyMMddHHmmss");
   String standardPdfDate = pdfDateFormat.format(yourDateObject);
   dateField.setValue(standardPdfDate);
   

3. 校验页面克隆逻辑
   确保每次新增表单页时，字段是独立克隆的，不是引用旧页面的字段，字段名要唯一（比如给不同页面的字段加前缀：page1_record1_date、page2_record1_date）。示例代码片段：

   // 克隆原表单页的字段
   PDField originalDateField = acroForm.getField("record1_date");
   PDField newDateField = (PDField) originalDateField.clone();
   newDateField.setPartialName("page2_record1_date"); // 重命名避免冲突
   acroForm.getFields().add(newDateField);
   

4. 升级PDFBox版本
   如果用的是2.0.x早期版本，直接升级到最新稳定版（比如2.0.32及以上），很多旧版本的表单填充bug已经被修复。

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