解决Error: Could not find or load main class org.springframework.boot.loader.launch.JarLauncher问题

在noah部署平台发布时遇到以下错误：

Error: Could not find or load main class org.springframework.boot.loader.lau

🔑 核心原理对比

表格

<!-- spring-boot-starter-parent POM 片段 -->
<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <executions>
        <execution>
          <id>repackage</id>
          <goals><goal>repackage</goal></goals> <!-- 已绑定到 package 阶段 -->
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

• Maven 继承机制 会将父 POM 的 <build> 配置（含插件绑定）完整传递给子项目
• 执行 mvn package 时：
  1. maven-jar-plugin 生成普通 JAR（如 app.jar）
  2. 自动触发 spring-boot-maven-plugin:repackage 目标
  3. 重打包为含 BOOT-INF/ 和 org/springframework/boot/loader/ 的可执行 Fat JAR
  4. 原始 JAR 重命名为 app.jar.original

❌ 仅使用 BOM（spring-boot-dependencies）时（需手动配置）

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-dependencies</artifactId>
      <version>3.x.x</version>
      <type>pom</type>
      <scope>import</scope> <!-- 仅导入依赖版本管理 -->
    </dependency>
  </dependencies>
</dependencyManagement>

• BOM 仅提供 <dependencyManagement>（统一依赖版本），不包含 <build> 配置
• Maven 不会继承 任何插件绑定逻辑
• 执行 mvn package 时：
  • 仅由 maven-jar-plugin 生成普通 JAR（无 BOOT-INF/，无 JarLauncher）
  • ❌ 无法通过 java -jar 启动 → 触发你遇到的 ClassNotFoundException: JarLauncher

 BOM 场景下正确配置（必须手动添加）

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <executions>
        <execution>
          <goals>
            <goal>repackage</goal> <!-- 显式绑定 repackage 目标 -->
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

💡 提示：若未配置 <executions>，即使声明了插件，mvn package 也不会触发 repackage（知识库 [2] 强调：插件目标需显式绑定到生命周期阶段）

🌰 类比理解

表格

💡 总结

• spring-boot-starter-parent = 完整构建模板（含插件绑定逻辑）→ 自动触发 repackage
• spring-boot-dependencies BOM = 纯依赖版本管理器 → 无构建逻辑，必须手动配置插件绑定
• 你遇到的 JarLauncher 找不到，本质是 未触发 repackage，生成的只是普通 JAR（验证方法：jar -tf app.jar | grep loader 应无输出）

选择方案时：

• 追求简洁 → 继承 spring-boot-starter-parent
• 需要自定义父 POM（如公司统一父 POM）→ 用 BOM + 手动配置插件绑定（缺一不可）