SpringBoot打包Jar与启动参数教程

Spring Boot 的 Jar 打包与启动看似简单，实则暗藏诸多易错细节：从因插件配置不当导致生成“瘦包”而引发 NoClassDefFoundError，到 JVM 参数与 Spring 配置参数位置颠倒造成的配置失效；从可执行 Jar 因自定义类加载机制带来的启动延迟与内存开销，到 Windows 下双击无响应的静默失败；再到外部配置路径协议（file:）、多配置文件分隔符、监控端点优化等关键实践——每个环节都严格遵循“约定大于配置”的设计哲学，差一个字符、少一个绑定、错一个顺序就可能让应用无法启动或行为异常，因此务必通过标准化 CI 脚本固化构建与启动流程，避免手工操作埋下隐患。

mvn package 打出来的 jar 为什么运行时报错 NoClassDefFoundError

Spring Boot 默认用 spring-boot-maven-plugin 打成可执行 jar，不是普通 jar。如果手动写了 maven-jar-plugin 或没配插件，mvn package 会生成一个不含依赖的“瘦包”，运行时自然找不到类。

• 检查 pom.xml 是否有 spring-boot-maven-plugin，且 绑定在 package 阶段
• 确认没同时启用 maven-jar-plugin 的 配置干扰了主类声明
• 运行前先用 jar -tf target/xxx.jar | head -20 看目录结构：正常 Spring Boot jar 里应有 BOOT-INF/classes/ 和 BOOT-INF/lib/，而不是直接平铺 com/xxx/

java -jar 启动时怎么传入配置文件和 JVM 参数

Spring Boot 支持多种外部配置加载方式，但顺序和写法容易混淆；JVM 参数必须放在 -jar 前，否则会被当成应用参数。

• JVM 参数（如堆大小、GC 日志）写在 java 命令后、-jar 前：java -Xmx512m -XX:+PrintGCDetails -jar app.jar
• Spring 配置参数（如 --server.port=8081）必须写在 app.jar 后面：java -jar app.jar --server.port=8081
• 外部 application.yml 优先级高于 jar 内部：加 --spring.config.location=file:./config/application.yml，注意路径是 file: 开头，且文件需存在
• 多个配置文件用逗号分隔：--spring.config.location=file:./a.yml,file:./b.yml

打出来的 jar 包启动慢、内存占用高，是不是打包有问题

不是打包问题，是 Spring Boot 可执行 jar 的加载机制决定的——它用自定义 ClassLoader 解压并加载 BOOT-INF/lib/ 下的 jar，比传统 classpath 启动略重，但这是功能代价。

• 首次启动慢常见于启用 Actuator + Prometheus + JMX 等监控端点，可关掉不用的：--management.endpoints.web.exposure.include=health,info
• 内存高往往因为默认堆设得大，或日志框架（如 Logback）加载了大量扫描逻辑；加 -Dlogback.debug=false 关闭调试输出能快一点
• 不要试图用 mvn clean compile assembly:single 替代 spring-boot-maven-plugin，那样会丢掉 Spring Boot 的启动器和资源定位逻辑，反而更不稳定

Windows 上双击 jar 没反应，命令行运行却正常

双击走的是系统默认的 javaw.exe，不显示控制台，出错也看不到日志；而 java -jar 走的是 java.exe，带标准输出。

• 别双击，改用命令行：java -jar app.jar 或写个 start.bat，内容为 @java -jar app.jar & pause
• 如果坚持双击，至少加日志输出：java -jar app.jar > app.log 2>&1，再把这行写进 bat
• 检查是否装了多个 JDK，注册表里默认 Java 关联可能指向 JRE 而非 JDK，导致缺少某些模块（如 java.desktop）引发静默失败

Spring Boot 的 jar 打包和启动看着简单，但每个环节都卡在「约定大于配置」的边界上——比如插件绑定时机、参数位置、路径协议写法，差一个字符就失效。真要稳定上线，建议把 mvn clean package 和 java -jar 命令固化进 CI 脚本，别靠手工拼。

本篇关于《SpringBoot打包Jar与启动参数教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！