调用XSSFWorkbook.close()报NoClassDefFoundError异常如何解决

触发该异常的核心原因是POI组件版本混装冲突：当前引入的poi包为3.9版本，poi-ooxml包为4.1.2版本，跨大版本的POI组件存在类结构、初始化逻辑的不兼容问题。
需要注意：java.lang.NoClassDefFoundError: Could not initialize class xxx不是指类文件不存在，而是目标类文件存在，但JVM加载类执行静态初始化逻辑时抛出异常，导致类初始化失败，后续所有访问该类的请求都会直接抛出这个错误。手动单独引入xercesImpl包没有解决版本冲突的根问题，因此无法修复异常。

• 统一所有POI相关依赖的版本，将poi包版本从3.9升级到和poi-ooxml一致的4.1.2，POI生态下的poi、poi-ooxml、poi-ooxml-schemas等组件必须使用完全相同的版本号，禁止跨大版本混装。正确依赖配置如下：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>

• 移除手动添加的2.12.0版本xercesImpl依赖。4.1.2版本的poi-ooxml已经通过依赖传递引入了适配版本的XML解析相关组件，手动引入不匹配的xerces版本反而会干扰类加载逻辑。修改完pom文件后执行mvn clean compile清空历史编译缓存，避免旧版本类文件残留。
• 如果完成上述操作后异常仍存在，执行mvn dependency:tree命令排查全量依赖树，检查是否有其他第三方组件通过依赖传递引入了3.x版本的旧POI包，如果存在则通过<exclusion>标签将冲突的旧版本POI依赖排除，保证运行时类路径下所有POI相关组件版本完全一致。

遇到Could not initialize class类型的错误时，不要第一时间盲目补依赖，优先排查类路径下是否存在同组件的多版本冲突、类版本不匹配问题，这类问题是触发类初始化失败的最高频原因。

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