使用poi-ooxml-5.2.5.jar导出xls时遇ClassNotFoundException问题求助

以下是针对java.lang.ClassNotFoundException: org.apache.commons.compress.archivers.zip.ZipArchiveInputStream的排查和解决步骤：

• 类加载器不一致排查
  你手动用ClassLoader能实例化类，但POI库可能使用了不同的类加载器（比如线程上下文类加载器、容器父类加载器）。可以尝试：

  • 在导出代码执行前，强制设置线程上下文类加载器为当前类的加载器：

    Thread.currentThread().setContextClassLoader(YourExportClass.class.getClassLoader());
    

  • 如果是Web应用，确认commons-compress的jar包放在WEB-INF/lib目录下，而非Tomcat等容器的共享库目录。

• 依赖版本冲突检查
  poi-ooxml 5.2.5依赖的commons-compress版本为1.21，若项目中存在其他版本的该依赖，会导致类加载混乱：

  • 用Maven或Gradle查看依赖树，排除冲突版本：
    Maven示例：

    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.5</version>
        <exclusions>
            <exclusion>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-compress</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-compress</artifactId>
        <version>1.21</version>
    </dependency>
    

• 打包部署完整性验证
  部分打包工具或自定义脚本可能遗漏commons-compress的类：

  • 解压最终生成的jar/war包，检查是否存在org/apache/commons/compress/archivers/zip/ZipArchiveInputStream.class文件；
  • 若使用Maven打包，确保maven-dependency-plugin配置正确，未过滤该依赖。

• 动态加载场景适配
  如果导出逻辑在动态加载的模块（如插件、热加载代码）中执行，需确保commons-compress的类能被该模块的类加载器访问：

  • 将commons-compress设置为模块间共享依赖；
  • 调整类加载器的委托顺序，优先从当前模块加载依赖类。

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