WebSphere环境下Pdfbox调用renderImageWithDPI触发LinkageError问题

• 排除冲突的传递依赖
  如果项目用Maven/Gradle构建，执行依赖树分析命令（如mvn dependency:tree），检查Pdfbox是否引入了额外的javax.imageio相关依赖（比如imageio-core、imageio-jpeg）。这些依赖会和Java 8自带的ImageIO类冲突，直接在依赖配置中排除它们：

  <!-- Maven示例：排除Pdfbox的ImageIO传递依赖 -->
  <dependency>
      <groupId>org.apache.pdfbox</groupId>
      <artifactId>pdfbox</artifactId>
      <version>2.0.30</version>
      <exclusions>
          <exclusion>
              <groupId>com.twelvemonkeys.imageio</groupId>
              <artifactId>imageio-core</artifactId>
          </exclusion>
          <exclusion>
              <groupId>com.twelvemonkeys.imageio</groupId>
              <artifactId>imageio-jpeg</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 配置WebSphere类加载器过滤规则
  登录WebSphere控制台，找到目标应用的类加载器设置：

  1. 进入应用程序 > 企业应用程序 > 你的应用 > 类加载和更新检测
  2. 在类加载器策略下，添加javax.imageio.*到父类加载器优先加载的类列表（不同WebSphere版本可能叫"过滤类"或"委托父类加载器的类"）
  3. 保存配置并重启应用，让JRE的Bootstrap类加载器优先加载ImageIO相关类，避免应用类加载器的Parent Last机制干扰

• 清理应用包中的JRE自带类
  解压你的WAR/EAR包，检查是否包含javax/imageio目录或相关类文件。如果存在，删除这些类——Java 8环境已经自带完整的ImageIO实现，不需要打包到应用中。

• 显式指定ImageIO的系统实现
  在调用PDFRenderer.renderImageWithDPI之前，添加代码强制使用JRE默认的ImageIO组件，避免加载应用类加载器中的自定义插件：

  // 禁用ImageIO缓存，减少类加载冲突风险
  ImageIO.setUseCache(false);
  
  // 显式选择系统类加载器加载的ImageReader
  Iterator<ImageReader> jpegReaders = ImageIO.getImageReadersByFormatName("jpeg");
  while (jpegReaders.hasNext()) {
      ImageReader reader = jpegReaders.next();
      if (reader.getClass().getClassLoader() == ClassLoader.getSystemClassLoader()) {
          ImageIO.setDefaultImageReader("jpeg", reader);
          break;
      }
  }
  

• 验证类加载器配置的一致性
  检查EAR中的所有模块是否统一使用Parent Last类加载策略，部分模块使用Parent First可能导致跨模块的类加载约束冲突。确保整个应用的类加载器策略一致。

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