Apache POI从4.12迁移至5.0生成Excel抛IllegalArgumentException问题咨询

报错本质是类路径下的commons-compress实现版本与POI 5.0的接口要求不匹配。
POI 5.0初始化ZipArchiveThresholdInputStream时，会强制校验传入的ZipFile实例返回的输入流是否实现commons-compress的InputStreamStatistics接口。这个接口是commons-compress 1.20版本才新增的能力，如果类加载时实际调用的是低于1.20版本的ZipFile实现，其内部匿名输入流没有实现该接口，就会直接抛出上述非法参数异常。哪怕项目主依赖声明了commons-compress 1.20，只要存在版本冲突、类加载顺序异常，就会触发该问题。

• 全量排查类路径的commons-compress版本冲突
  通过依赖分析工具定位所有引入commons-compress的传递依赖，过滤版本低于1.20的条目，排除老旧版本的依赖传递。常见冲突来源包括未清理干净的POI 4.x残留依赖、老旧版Office文档处理组件、基于Ant任务的压缩工具依赖。Maven项目可直接执行mvn dependency:tree -Dincludes=org.apache.commons:commons-compress快速定位版本链路，Gradle项目可通过gradle dependencies命令检索对应依赖的引入路径。
• 排查跨类加载的版本污染
  部署在Web容器（如Tomcat、带外置类加载的微服务场景）的项目，需检查容器共享类目录（如Tomcat根目录的lib文件夹）是否存在老旧版本的POI、commons-compress Jar包。这类公共目录的类会优先于应用内部包被加载，会直接绕过应用内的版本匹配逻辑。
• 用官方BOM统一管控依赖版本
  不要手动单独指定commons-compress的版本，直接引入POI 5.0对应的官方BOM包，由BOM自动拉取所有配套关联依赖的正确版本，避免手动配置版本导致的错配。
• 临时绕开校验（仅适用于完全从零新建Excel的场景）
  由于场景是从空内存构建Excel文件、不存在读取外部恶意压缩包的风险，可通过JVM启动参数关闭Zip炸弹防护的强制校验，跳过阈值输入流的接口校验逻辑。

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