编译WAR文件时无法访问org.apache.poi.xssf.usermodel.XSSFSheet如何解决？

• 确认依赖完整性：XSSFSheet属于POI的OOXML模块，仅依赖poi.jar不够，必须确保以下核心jar包都在类路径中，且版本统一：

  • poi-ooxml.jar（核心XSSF实现）
  • poi-ooxml-schemas.jar（OOXML schema定义）
  • xmlbeans.jar（XML处理依赖）
  • 辅助依赖如commons-codec.jar、commons-collections4.jar等

• 检查构建工具依赖配置：如果用Maven或Gradle管理项目，确保依赖声明正确，避免仅引入基础POI包：
  Maven示例：

  <dependency>
      <groupId>org.apache.poi</groupId>
      <artifactId>poi-ooxml</artifactId>
      <version>你的POI版本号</version>
      <scope>compile</scope> <!-- 若容器未提供依赖，请勿用provided，否则WAR包不会包含该jar -->
  </dependency>
  

  Gradle示例：

  implementation 'org.apache.poi:poi-ooxml:你的POI版本号'
  

• 同步IDE与构建工具依赖：手动在IDE添加jar但未更新构建工具配置时，编译WAR会使用构建工具的依赖集而非IDE的。执行构建命令刷新依赖：

  • Maven：mvn clean install -U
  • Gradle：./gradlew clean build --refresh-dependencies

• 验证WAR包内容：解压生成的WAR包，检查WEB-INF/lib目录下是否包含所有必需的POI相关jar。如果缺失，说明构建工具未将依赖打包，需调整依赖的scope为compile（Maven）或implementation（Gradle）。

• 排查版本冲突：项目中其他依赖可能引入不同版本的POI，导致类加载冲突。用命令查看依赖树：

  • Maven：mvn dependency:tree
  • Gradle：./gradlew dependencies
    找到冲突的POI版本后，在对应依赖中排除旧版本：

  <dependency>
      <groupId>冲突依赖的groupId</groupId>
      <artifactId>冲突依赖的artifactId</artifactId>
      <version>版本号</version>
      <exclusions>
          <exclusion>
              <groupId>org.apache.poi</groupId>
              <artifactId>poi</artifactId>
          </exclusion>
          <exclusion>
              <groupId>org.apache.poi</groupId>
              <artifactId>poi-ooxml</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 核对JDK版本兼容性：高版本POI（如4.x及以上）要求JDK 8或更高版本。如果你的编译环境JDK版本过低，会导致类无法正常加载，需升级JDK至符合要求的版本。

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