Spring Boot集成Apache Commons CSV运行时遇NoClassDefFoundError求助

针对你遇到的java.lang.NoClassDefFoundError: org/apache/commons/csv/CSVFormat错误，可按以下步骤排查解决：

• 检查依赖范围
  确保你的commons-csv依赖没有设置错误的scope（比如provided或test），这类scope会导致依赖只在编译或测试阶段可用，运行时缺失。保持依赖配置如下：

  <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-csv</artifactId>
      <version>1.9.0</version>
  </dependency>
  

• 清理并重新构建项目
  执行Maven命令清理缓存并强制更新依赖：

  mvn clean install -U
  

  同时在IDE中重新导入Maven项目（比如IDEA右键pom.xml选择「Maven → Reload Project」），确保依赖被正确加载。

• 验证本地Maven仓库
  前往本地Maven仓库路径（默认~/.m2/repository/org/apache/commons/commons-csv/1.9.0），检查commons-csv-1.9.0.jar是否存在且未损坏。如果文件缺失或损坏，删除该目录后重新执行mvn install。

• 检查Spring Boot打包配置
  若使用spring-boot-maven-plugin打包，确认插件配置中没有通过<excludeGroupIds>或<excludeArtifactIds>排除commons-csv依赖。标准的Spring Boot打包插件配置不会自动排除此类依赖，若有自定义排除规则需调整。

• 尝试兼容的依赖版本
  Spring Boot父pom会管理部分依赖版本，可尝试移除version标签，让父pom自动选择兼容版本：

  <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-csv</artifactId>
  </dependency>
  

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