
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 中可显式配置插件以增强可靠性(虽非必需,但推荐):
org.springframework.boot spring-boot-maven-plugin com.jvc.interconnectingflights.app.InterconnectingFlightsApplication
这样能确保 repackage 明确识别主类,避免多模块项目中推断失败。
总结:Spring Boot 的可执行性完全依赖 spring-boot-maven-plugin 的 repackage 流程。脱离该流程(如 IDE 简化构建、手动打包)必然导致应用无法作为独立服务运行。始终以 mvn clean package 为准,并用 java -jar 验证,是规避此类“秒退”问题的黄金准则。










