Spring Boot项目部署命令java -jar的各种参数及作用详解
作者：hoho不爱喝酒
前言
在实际生产环境中，我们经常使用 java -jar 命令来部署 Spring Boot 项目。为了满足不同场景的需求，可以通过一些常用参数来优化运行时行为和性能。本文将全面解析 java -jar 命令的各种参数及其作用，帮助你更好地管理和优化 Spring Boot 项目的部署。
一、基础命令结构
java -jar [选项] 应用程序名.jar
这里的 应用程序名.jar 是你打包好的 Spring Boot 项目 JAR 文件，[选项] 是可选的 JVM 或应用参数。
二、常见的 java 命令参数
以下是一些常见的 java 命令参数及其用途。
1. 设置内存大小
java -Xms512m -Xmx1024m -jar 应用程序名.jar
- -
Xms：设置 JVM 启动时分配的最小堆内存大小。例如-Xms512m表示最小内存为 512MB - -
Xmx：设置 JVM 可使用的最大堆内存大小。例如-Xmx1024m表示最大内存为 1024MB
2. 配置垃圾回收器
java -XX:+UseG1GC -jar 应用程序名.jar
-XX:+UseG1GC：使用 G1 垃圾回收器，适用于需要低延迟的场景。- 其他选项：
-XX:+UseParallelGC：使用并行垃圾回收器，适合高吞吐量的场景。- -
XX:+UseConcMarkSweepGC：使用 CMS（Concurrent Mark-Sweep）垃圾回收器，适合响应时间要求高的场景。
3. 配置线程栈大小
java -Xss512k -jar 应用程序名.jar
- -
Xss：设置每个线程的栈大小。默认值通常为 1MB，设置较小的值可以支持更多线程，但可能增加栈溢出的风险。
4. 设置系统属性
java -Dserver.port=8081 -Dspring.profiles.active=prod -jar 应用程序名.jar
-Dkey=value：设置系统属性。例如：server.port：修改 Spring Boot 应用的默认端口。spring.profiles.active：指定运行的配置文件（如prod表示生产环境）。
5. 生成 GC 日志
java -Xlog:gc*:file=gc.log:time,uptime,level -jar 应用程序名.jar
-Xlog:gc*：开启 GC 日志记录。file=gc.log：将日志输出到指定文件。time,uptime,level：记录时间戳、运行时间和日志级别等信息。
6. 远程调试
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar 应用程序名.jar
-agentlib:jdwp：启用 Java 调试协议（JDWP）。transport=dt_socket：使用套接字进行通信。server=y：启用调试服务器。suspend=n：应用程序启动后不暂停。address=*:5005：监听调试端口 5005。
三、Spring Boot 专用参数
Spring Boot 提供了一些特殊的运行参数，可以通过 --参数名=值 的形式传递。
1. 修改端口
java -jar 应用程序名.jar --server.port=8081
--server.port：修改 Spring Boot 默认运行端口。
2. 指定配置文件
java -jar 应用程序名.jar --spring.config.location=/path/to/application.properties
--spring.config.location：指定外部配置文件路径。
3. 激活某个 Profile
java -jar 应用程序名.jar --spring.profiles.active=dev
--spring.profiles.active：激活指定的配置文件（如 dev 表示开发环境）。
4. 配置日志文件路径
java -jar 应用程序名.jar --logging.file.name=/path/to/logfile.log
--logging.file.name：指定日志文件位置。--logging.level.root=DEBUG：设置全局日志级别。
5. 配置随机端口
java -jar 应用程序名.jar --server.port=0
--server.port=0：让应用随机选择一个可用端口运行。
四、综合示例
以下是一个综合示例，展示如何结合多种参数运行 Spring Boot 应用程序：
java -Xms512m -Xmx1024m -XX:+UseG1GC
-Dserver.port=8081 -Dspring.profiles.active=prod
-Xlog:gc*:file=gc.log:time,uptime,level
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
-jar 应用程序名.jar --spring.config.location=/config/application.properties
五、参数优化建议
1、根据硬件资源设置内存大小：
小型应用：
-Xms256m -Xmx512m中型应用：
-Xms512m -Xmx1024m大型应用：
-Xms1g -Xmx2g
2、选择合适的垃圾回收器：
响应时间优先：使用 G1 垃圾回收器。
吞吐量优先：使用 Parallel 垃圾回收器。
3、为生产环境启用远程调试：
但需注意安全性，避免调试端口暴露。
4、外置配置文件：
将敏感配置（如数据库连接信息）外置，避免硬编码到应用中。
总结
通过合理使用 java -jar 命令的各种参数，可以有效提高 Spring Boot 项目的运行效率和可维护性。在实际使用时，需根据具体场景进行调整，选择最适合的配置。