JVM-（8）JVM启动的常用命令以及参数

原创已于 2025-08-25 17:57:53 修改 · 879 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#jvm

于 2025-08-22 10:24:32 首次发布

JVM 专栏收录该内容

10 篇文章

订阅专栏

JVM启动的常用命令以及参数

在上文 JVM 堆内存逻辑分区中已经使用过一些 jvm 启动命令，本文着重讲述JVM启动命令用法以及一些常用的参数

一. 基本命令格式

java [options] classname [args...]
java [options] -jar filename.jar [args...]

① [options] - 命令行选项（可选）

比如标准参数 -version ，非标准参数 -Xms，非稳定参数 -XX:+PrintGCDetails，下面有详细说明

② classname - 要执行的类（必需）

指定包含 main 方法的类的全限定名：

java com.example.MyApp

③ [args…] - 传递给 main 方法的参数（可选）

这些参数会传递给应用程序的 main 方法的 String[] args 参数：

java MyApp arg1 arg2 arg3

④ 完整示例

# 复杂的实际应用示例
java \
  -Xms1g -Xmx4g \                  # 堆内存设置
  -XX:+UseG1GC \                   # 使用 G1 垃圾收集器
  -XX:MaxGCPauseMillis=200 \       # 最大 GC 暂停时间
  -Dspring.profiles.active=prod \  # Spring 环境配置
  -Dlog4j.configurationFile=conf/log4j2.xml \  # 日志配置
  -cp "lib/*:app.jar:config" \     # 类路径设置
  com.example.MainApplication \    # 主类
  --server.port=8080 \             # 应用参数
  --database.url=jdbc:mysql://localhost:3306/mydb

二. JVM 启动常用命令参数分类

JVM 常用命令参数主要分为三类：

标准参数
以 - 开头，是所有 JVM 实现必须支持的参数，例如：
-version：显示版本信息
-help：显示所有标准参数列表
非标准参数
以 -X 开头，默认支持但可能不保证所有 JVM 实现兼容，例如：
-Xms：设置初始堆内存（如 -Xms512m） ‌
-Xmx：设置最大堆内存（如 -Xmx2g） ‌
-Xmn：设置新生代大小（如 -Xmn2g）
非稳定参数
以 -XX 开头，可能随版本变更而取消，需谨慎使用，例如：
-XX:MetaspaceSize：设置元空间初始大小
-XX:+PrintGCDetails：输出详细 GC 日志 ‌

三. 常用命令举例

非稳定参数举例

① java -XX:+PrintCommandLineFlags

主要作用是：在 JVM 启动时，打印出那些被显式设置或由 JVM 自动设置的关键 -XX 参数及其值。

java -XX:+PrintCommandLineFlags -version

C:\Users\Administrator>java -XX:+PrintCommandLineFlags -version
-XX:InitialHeapSize=267006528 -XX:MaxHeapSize=4272104448 -XX:+PrintCommandLineFlags -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:-UseLargePagesIndividualAllocation -XX:+UseParallelGC
java version "1.8.0_121"
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

解读：

-XX:InitialHeapSize=267006528 ，JVM 根据当前机器的内存，自动设置的初始堆大小约为 255 MB。
-XX:MaxHeapSize=4272104448 ，JVM 自动设置的最大堆大小约为 4 GB。（大概是电脑内存的 1/4）
-XX:+PrintCommandLineFlags ，我们自己设置的参数也被打印出来了
-XX:+UseCompressedClassPointers -XX:+UseCompressedOops，JVM 自动启用了压缩指针（64位系统上的优化，节省内存）。
-XX:-UseLargePagesIndividualAllocation
-XX:+UseParallelGC，JVM 自动选择了并行垃圾收集器（Parallel GC）作为默认收集器。（这在JDK 8及之前是默认行为，高版本JDK默认可能是G1）

由上述 jvm 指令格式可知 classname 是必须参数，但是我们不需要运行某个类，只需要查看参数设置，那么添加 -version 参数可以告诉 JVM 不要尝试执行任何应用程序，只需显示版本信息然后退出
如果不加上 -version 会报如下错：

② java -XX:+PrintFlagsInitial

查看所有不稳定指令的默认值

③ java -XX:+PrintFlagsFinal

查看所有不稳定指令最终生效的实际值

④ 打印GC日志

命令如下：

java -XX:+PrintGC -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:gc.log -jar yourapp.jar

-XX:+PrintGC (或 -verbose:gc)：表示开启简要 GC 日志。
-XX:+PrintGCDetails：（强烈建议加上）打印详细的 GC 信息，包括各区（Eden, Survivor, Old）在 GC 前后的内存使用情况。没有这个参数，日志信息会非常有限。
-XX:+PrintGCDateStamps 或 -XX:+PrintGCTimeStamps：
- -XX:+PrintGCDateStamps：在日志中添加日期时间戳（如 2024-05-27T10:00:00.123+0800）。
- -XX:+PrintGCTimeStamps：在日志中添加从 JVM 启动开始计算的相对时间戳（如 12.345 秒）。生产环境推荐使用 PrintGCDateStamps。
-Xloggc:<file_path>：（强烈建议加上）将 GC 日志输出到文件，而不是控制台。例如 -Xloggc:/logs/gc.log。

增加高级设置

java -XX:+PrintGC -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCCause -XX:+PrintTenuringDistribution -Xloggc:gc.log -jar yourapp.jar

-XX:+PrintGCCause：打印触发 GC 的原因（如 Allocation Failure, System.gc() 等）。这在 JDK 8 之后通常是默认开启的。
-XX:+PrintTenuringDistribution：打印晋升年龄阈值（对象在 Survivor 区熬过多少次 GC 才能进入老年代）的信息，对调优 Survivor 区大小非常有帮助。
-XX:+PrintHeapAtGC：在每次 GC 前后打印堆的详细信息。非常详细，但日志量会急剧增大，主要用于深度调试。
-XX:+PrintReferenceGC：打印处理各种引用（软引用、弱引用、虚引用、Finalizer）的耗时。

常见组合

java -Xloggc:D:/test/dump/gc.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=10M

1） -Xloggc:D:/test/dump/gc.log

作用：这是指定GC日志文件输出路径和基础文件名的核心参数。
解释：JVM会将GC日志写入到指定的文件中。这里的路径是 D:/test/dump/gc.log。

2） -XX:+PrintGCDetails

作用：开启详细的GC日志输出。这是最重要的参数，没有它，日志只会非常简略。
解释：加上这个参数后，GC日志会包含每一次GC（Young GC和Full GC）的详细信息，例如：
- GC类型（YoungGC, Full GC）
- GC前/后各个内存区域（Eden, Survivor, Old, Metaspace）的使用容量和总容量
- 本次GC的耗时（以秒为单位）

3）-XX:+PrintGCDateStamps

作用：在每行GC日志前加上一个日期时间戳。
解释：这对于问题排查至关重要。它让你能清楚地知道每一次GC发生的具体绝对时间（例如 2024-05-27T10:23:45.123+0800），方便你将GC事件与当时的业务监控（如CPU飙升、请求量激增）进行关联分析。

4）-XX:+UseGCLogFileRotation

作用：启用GC日志文件轮转（滚动）。
解释：如果不启用这个参数，所有的GC日志都会写入一个文件中（即 gc.log），这个文件会越来越大，最终可能占满磁盘空间。启用后，JVM会在满足条件时自动创建新的日志文件，实现轮转。

5）-XX:NumberOfGCLogFiles=5

作用：指定最多保留多少个轮转的GC日志文件。必须和 -XX:+UseGCLogFileRotation 一起使用。
解释：这里设置为 5，意味着JVM会最多保留5个历史GC日志文件，加上当前正在写入的，总共最多6个文件。当轮转文件数超过5个时，最老的那个文件会被自动删除。

6）-XX:GCLogFileSize=10M

作用：指定每个GC日志文件的最大大小。必须和 -XX:+UseGCLogFileRotation 一起使用。
解释：这里设置为 10M。当当前正在写入的 gc.log 文件大小达到10MB时，JVM会将其重命名（如重命名为 gc.log.0），然后创建一个新的 gc.log 文件来继续写入。之前的文件会依次向后轮转。

GC 日志生成效果：

GC 日志结果：

日志解释：

[Full GC (System.gc()) [PSYoungGen: 5297K->0K(22528K)] ：使用的是Parallel Scavenge收集器。表示发生了FullGC，GC前年轻代使用了5297KB，GC后年轻代使用量变为0KB（所有存活对象都被移走）。(22528K): 年轻代的总容量为22528KB（约22MB）。
[ParOldGen: 62424K->64140K(68608K)]：老年代 (Old Generation) 的回收情况，使用的是Parallel Old收集器。62424K->64140K: 严重问题所在！ GC前老年代使用了62424KB，GC后竟然变成了64140KB。使用量不降反增了！(68608K): 老年代的总容量为68608KB（约67MB）。计算使用率：64140K / 68608K ≈ 93.5%。
67722K->64140K(91136K)：整个堆 (Heap) 的回收情况。67722K->64140K: GC前整个堆使用了67722KB，GC后变为64140KB。回收了约3.5MB，但正如上述老年代所示，这很可能是年轻代清空带来的，老年代反而增长了。(91136K): 整个堆的总容量为91136KB（约89MB）。YoungGen(22MB) + OldGen(67MB) ≈ 89MB。
[Metaspace: 37670K->37670K(1085440K)]：元空间 (Metaspace) 的回收情况。37670K->37670K: 使用量前后无变化。(1085440K): 元空间的最大容量约为1GB。元空间使用正常且稳定，没有问题。
0.0273593 secs：这次Full GC所花费的总时间（27.3毫秒）。

⑤ 设置堆内存溢出时自动生成Dump文件

Dump 文件（转储文件）是计算机程序在特定时间点的状态快照，它记录了程序在发生错误、崩溃或特定触发条件时的内存内容、执行状态和系统信息，开发人员可以根据Dump文件事后分析到底发生了什么问题。
命令示例：

java -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/tmp/heapdump.hprof -Xmx512m -jar yourapp.jar

-XX:+HeapDumpOnOutOfMemoryError：启用堆内存溢出时自动生成 dump 文件的功能
-XX:HeapDumpPath= ：指定 dump 文件的保存路径和文件名，可以指定文件名，也可以只指定目录，当只指定目录时，JVM 会自动生成文件名，格式为：java_pid.hprof