Gradle配置POI5.0.0依赖后运行时无法加载SXSSFWorkbook类求助

核心问题根源 #

这类问题的共性是编译流程完全正常，运行时才触发类加载失败——因为编译阶段只校验类的方法签名是否匹配，运行时JVM会加载类的实际字节码做兼容性校验，版本不兼容、类冲突的场景下，JVM会抛出误导性的“类不存在”报错。你的Gradle依赖存在严重的版本错配、冗余冲突，是触发这类报错的核心原因，具体问题点：

• 依赖版本碎片化：虽然你引入了5.0.0版本的poi、poi-ooxml，但同时手动引入了和5.x不兼容的旧版依赖：
  • poi-ooxml-schemas:4.0.0：该包在POI 5.x版本中已经被poi-ooxml-lite/poi-ooxml-full完全替代，4.0.0版本和5.x的核心类存在二进制兼容问题
  • xmlbeans:2.3.0：POI 5.0.0官方匹配的xmlbeans版本是5.1.1，你手动强制降级到2.3.0会直接破坏整个ooxml模块的类加载链路
• 互斥依赖共存：你同时引入了poi-ooxml-full:5.0.0和poi-ooxml-lite:5.0.0，这两个包是针对不同场景的互斥schema实现，同时加载会导致类路径冲突，核心类无法被类加载器正确识别
• 冗余重复依赖：commons-compress:1.20被重复声明了两次，虽不会直接导致类加载失败，但会增加打包冲突的概率

现场验证步骤 #

不要只看编译时的依赖，必须校验运行时类路径的实际加载情况：

• 执行Gradle命令./gradlew dependencies --configuration runtimeClasspath，梳理所有运行时生效的POI相关依赖，确认是否存在被其他依赖传递引入的旧版POI包（比如很多第三方组件会默认传递引入3.x、4.x版本的POI，导致你手动声明的5.0.0版本被依赖仲裁规则覆盖）
• 打可执行Jar场景（Spring Boot/Shadow插件打包）：解压打包后的产物，检查BOOT-INF/lib（或对应依赖目录）下是否存在包含org.apache.poi.xssf.streaming.SXSSFWorkbook类的poi-ooxml jar包，排查打包插件是否因为类冲突规则把核心类给误排除
• 容器/Web容器运行场景：检查容器共享类加载目录下是否存在旧版本的POI jar，是否存在类加载优先级过高导致项目内的新版类被覆盖的情况

可直接复用的修正依赖配置 #

删掉所有版本不匹配的冗余依赖，统一使用POI官方推荐的版本组合：

// 声明统一版本变量，避免版本错配
def poiVersion = "5.0.0"
// 核心POI基础包
implementation "org.apache.poi:poi:${poiVersion}"
// OOXML格式支持包
implementation "org.apache.poi:poi-ooxml:${poiVersion}"
// 按需选择schema实现，不要同时引入lite和full
// 通用场景选lite即可，需要完整ECMA-376所有Schema支持时再换full
implementation "org.apache.poi:poi-ooxml-lite:${poiVersion}"
// 其他业务需要的第三方依赖正常保留即可，不要手动覆盖POI自带的传递依赖版本

注意：不要手动指定xmlbeans、poi-ooxml-schemas的版本，让Gradle根据POI的官方POM自动匹配兼容版本即可，手动指定低版本是绝大多数POI运行时类加载问题的诱因。

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