Spring Boot 项目部署命令 java -jar 的各种参数及作用

文章目录

前言
一、基础命令结构
[二、常见的 java 命令参数](#二、常见的 java 命令参数)
- [1. 设置内存大小](#1. 设置内存大小)
- [2. 配置垃圾回收器](#2. 配置垃圾回收器)
- [3. 配置线程栈大小](#3. 配置线程栈大小)
- [4. 设置系统属性](#4. 设置系统属性)
- [5. 生成 GC 日志](#5. 生成 GC 日志)
- [6. 远程调试](#6. 远程调试)
[三、Spring Boot 专用参数](#三、Spring Boot 专用参数)
- [1. 修改端口](#1. 修改端口)
- [2. 指定配置文件](#2. 指定配置文件)
- [3. 激活某个 Profile](#3. 激活某个 Profile)
- [4. 配置日志文件路径](#4. 配置日志文件路径)
- [5. 配置随机端口](#5. 配置随机端口)
四、综合示例
五、参数优化建议
总结

前言

在实际生产环境中，我们经常使用 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 项目的运行效率和可维护性。在实际使用时，需根据具体场景进行调整，选择最适合的配置。