使用iText 2.2处理PDF时出现间歇性java.lang.ClassCastException求助

问题根因分析 #

从堆栈信息看，错误发生在PdfReader.eliminateSharedStreams方法中，出现PdfDictionary强转PRIndirectReference失败的情况。结合“重启Tomcat后问题消失、间歇性触发”的特征，核心原因大概率是多线程环境下的线程安全问题，或是老旧版本遗留的bug、资源泄漏导致的对象状态污染。

具体解决思路 #

• 确保PdfReader实例线程隔离：iText 2.2的PdfReader并非线程安全，绝对不能在多线程间复用实例，也禁止用静态变量持有。每个PDF处理请求都要创建全新的PdfReader对象，处理完成后立即销毁。
• 升级iText版本：iText 2.2是近20年前的老旧版本，官方早已停止维护，大量线程安全、PDF解析相关的bug在后续版本（如iText 5.x系列）中已修复。升级到稳定的新版本是最彻底的解决方案。
• 严格管理资源释放：每次使用PdfReader后必须调用close()方法释放资源，避免内存中残留异常的PDF对象状态。如果项目基于Java 7及以上开发，建议用try-with-resources语法自动管理资源：

  try (PdfReader reader = new PdfReader(pdfFile)) {
      // PDF处理逻辑
  }
  

• 增加异常重试逻辑：针对间歇性触发的异常，可在捕获ClassCastException后，使用全新的PdfReader实例重试一次处理流程，规避当前线程的异常状态影响。
• 补充诊断日志：在PDF处理的关键节点（创建PdfReader、开始签章、出错时）添加日志，记录线程ID、PDF文件标识、PdfReader实例哈希值等信息，帮助定位触发问题的具体并发场景或特殊PDF结构。

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