登录
首页 >  文章 >  java教程

SpringBoot打包JAR退出解决方法

时间:2026-02-23 17:18:48 240浏览 收藏

Spring Boot 应用打包后运行秒退,根本原因在于生成的并非真正的可执行 Fat Jar——常见于 VSCode 等 IDE 默认构建方式绕过了 spring-boot-maven-plugin 的 repackage 过程,导致 JAR 缺少启动器类、依赖库及关键 MANIFEST 属性,无法维持应用上下文;唯有通过标准命令 `mvn clean package` 构建,才能生成含 BOOT-INF、JarLauncher 和正确启动配置的自包含 Jar,再配合简单验证(如解压检查或 `java -Djarmode=help -jar`)即可快速定位并彻底解决“启动即关闭”的顽疾。

Spring Boot 应用打包为 JAR 后立即退出的解决方案

Spring Boot 应用通过 java -jar 运行时秒退,但 mvn spring-boot:run 或 IDE 内运行正常——根本原因通常是构建方式错误:VSCode Java Project Manager 生成的 JAR 缺少 Spring Boot 打包插件支持,未嵌入启动器和依赖,导致容器无法持续运行。

Spring Boot 应用打包后立即关闭(如日志显示 Started ... in X seconds 随即进入 Closing ApplicationContext),本质是该 JAR 并非可执行的 Fat Jar,而是普通 Maven 构建生成的 bare-bones JAR(仅含编译类,无依赖、无 Main-Class 和 Spring-Boot-Classes 等关键 MANIFEST 属性)。VSCode 的 Java Project Manager 默认调用的是基础 mvn compile 或 mvn jar:jar,不会触发 spring-boot-maven-plugin 的 repackage 目标,因此生成的 JAR 不具备自启动能力。

✅ 正确构建可执行 JAR 的唯一可靠方式是显式执行:

mvn clean package

该命令会自动触发 spring-boot-maven-plugin 的 repackage 目标(默认绑定在 package 生命周期),生成位于 target/interconnecting-flights-0.0.1-SNAPSHOT.jar 的可执行 Fat Jar,其 MANIFEST.MF 包含:

Main-Class: org.springframework.boot.loader.JarLauncher
Start-Class: com.jvc.interconnectingflights.app.InterconnectingFlightsApplication
Spring-Boot-Version: 3.0.2
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/

⚠️ 常见误区与验证步骤:

  • ❌ 错误操作:直接在 VSCode 中点击 “Build Project” 或使用其内置打包按钮(不走 mvn package);
  • ❌ 错误操作:使用 jar -cf app.jar ... 手动归档(缺失启动器逻辑);
  • ✅ 验证 JAR 是否合规:解压后检查是否存在 BOOT-INF/ 目录及 org/springframework/boot/loader/JarLauncher.class;
  • ✅ 快速验证:运行 java -Djarmode=help -jar target/*.jar,若输出 jarmode: 'help' is not a valid jarmode 则说明是合法 Spring Boot JAR(支持 jarmode);否则为普通 JAR。

? 补充建议:
在 pom.xml 中可显式配置插件以增强可靠性(虽非必需,但推荐):

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.jvc.interconnectingflights.app.InterconnectingFlightsApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

这样能确保 repackage 明确识别主类,避免多模块项目中推断失败。

总结:Spring Boot 的可执行性完全依赖 spring-boot-maven-plugin 的 repackage 流程。脱离该流程(如 IDE 简化构建、手动打包)必然导致应用无法作为独立服务运行。始终以 mvn clean package 为准,并用 java -jar 验证,是规避此类“秒退”问题的黄金准则。

今天关于《SpringBoot打包JAR退出解决方法》的内容就介绍到这里了,是不是学起来一目了然!想要了解更多关于的内容请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>