在Java开发中，使用Maven构建SpringBoot应用时，经常会遇到”找不到或无法加载主类”的错误。这个问题通常与打包配置有关，特别是当项目同时使用了多个打包插件时。本文将深入分析这一问题的原因和解决方案。

问题现象

当我们使用命令java -cp target/xxx-jar-with-dependencies.jar com.example.MainClass 运行应用时，出现以下错误：

错误: 找不到或无法加载主类 com.example.MainClass

这表明Java虚拟机无法在指定的JAR包中找到主类，即使该类确实存在于源代码中。

原因分析

1. SpringBoot打包机制与传统打包的冲突

SpringBoot应用使用spring-boot-maven-plugin 打包时，会将类文件放在BOOT-INF/classes 目录下，而不是传统JAR包的根目录。这导致使用-cp 参数指定类路径时，JVM无法在预期位置找到主类。

2. 多插件打包导致的结构混乱

当项目同时配置了spring-boot-maven-plugin 和maven-assembly-plugin 时，两个插件会各自执行打包逻辑，可能导致最终JAR包结构不符合预期。特别是，maven-assembly-plugin 可能无法正确处理SpringBoot的特殊目录结构。

3. 主类声明位置不正确

在Maven配置中，主类可以在多个位置声明：

• spring-boot-maven-plugin 的<configuration><mainClass> 元素
• maven-assembly-plugin 的<archive><manifest><mainClass> 元素
• maven-jar-plugin 的<archive><manifest><mainClass> 元素
  如果这些配置不一致或缺失，可能导致生成的JAR包中没有正确的主类信息。

解决方案

1. 禁用SpringBoot重新打包功能

如果使用maven-assembly-plugin 创建包含依赖的JAR包，可以禁用SpringBoot的重新打包功能：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

2. 使用正确的运行命令

对于SpringBoot应用，应使用java -jar 命令而非java -cp 命令：

java -jar target/application.jar

3. 统一打包策略

选择一种打包策略并坚持使用：

• 使用SpringBoot的打包机制：依赖spring-boot-maven-plugin
• 使用传统打包：依赖maven-assembly-plugin 或maven-shade-plugin
  避免混合使用多种打包插件，以防止目录结构冲突。

4. 检查类路径和包名

确保源代码中的包名与Maven配置中声明的主类包名完全一致，包括大小写。同时，验证编译后的类文件确实存在于JAR包中的预期位置。