4. JVM 运行时参数
4.1 JVM 参数选项
参数来源:https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html
类型一:标准参数选项
特点:
- 比较稳定,后续版本基本不会变化
- 以
-开头
直接在 DOS 窗口中运行 java 或者 java -help 可以看到所有的标准选项
- JDK 8
- JDK 21
D:\Java\jdk-1.8\bin>java -help
用法: java [-options] class [args...]
(执行类)
或 java [-options] -jar jarfile [args...]
(执行 jar 文件)
其中选项包括:
-d32 使用 32 位数据模型 (如果可用)
-d64 使用 64 位数据模型 (如果可用)
-server 选择 "server" VM
默认 VM 是 server.
-cp < 目录和 zip/jar 文件的类搜索路径 >
-classpath < 目录和 zip/jar 文件的类搜索路径 >
用 ; 分隔的目录, JAR 档案
和 ZIP 档案列表, 用于搜索类文件。
-D< 名称 >=< 值 >
设置系统属性
-verbose:[class|gc|jni]
启用详细输出
-version 输出产品版本并退出
-version:< 值 >
警告: 此功能已过时, 将在
未来发行版中删除。
需要指定的版本才能运行
-showversion 输出产品版本并继续
-jre-restrict-search | -no-jre-restrict-search
警告: 此功能已过时, 将在
未来发行版中删除。
在版本搜索中包括 / 排除用户专用 JRE
-? -help 输出此帮助消息
-X 输出非标准选项的帮助
-ea[:<packagename>...|:<classname>]
-enableassertions[:<packagename>...|:<classname>]
按指定的粒度启用断言
-da[:<packagename>...|:<classname>]
-disableassertions[:<packagename>...|:<classname>]
禁用具有指定粒度的断言
-esa | -enablesystemassertions
启用系统断言
-dsa | -disablesystemassertions
禁用系统断言
-agentlib:<libname>[=< 选项 >]
加载本机代理库 <libname>, 例如 -agentlib:hprof
另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
-agentpath:<pathname>[=< 选项 >]
按完整路径名加载本机代理库
-javaagent:<jarpath>[=< 选项 >]
加载 Java 编程语言代理, 请参阅 java.lang.instrument
-splash:<imagepath>
使用指定的图像显示启动屏幕
有关详细信息, 请参阅 http://www.oracle.com/technetwork/java/javase/documentation/index.html。
C:\Users\Administrator>java -help
用法:java [options] < 主类 > [args...]
(执行类)
或 java [options] -jar <jar 文件 > [args...]
(执行 jar 文件)
或 java [options] -m < 模块 >[/< 主类 >] [args...]
java [options] --module < 模块 >[/< 主类 >] [args...]
(执行模块中的主类)
或 java [options] < 源文件 > [args]
(执行单个源文件程序)
将主类、源文件、-jar <jar 文件 >、-m 或
--module < 模块 >/< 主类 > 后的参数作为参数
传递到主类。
其中,选项包括:
-cp < 目录和 zip/jar 文件的类搜索路径 >
-classpath < 目录和 zip/jar 文件的类搜索路径 >
--class-path < 目录和 zip/jar 文件的类搜索路径 >
使用 ; 分隔的, 用于搜索类文件的目录, JAR 档案
和 ZIP 档案列表。
-p < 模块路径 >
--module-path < 模块路径 >...
用 ; 分隔的目录列表, 每个目录
都是一个包含模块的目录。
--upgrade-module-path < 模块路径 >...
用 ; 分隔的目录列表, 每个目录
都是一个包含模块的目录, 这些模块
用于替换运行时映像中的可升级模块
--add-modules < 模块名称 >[,< 模块名称 >...]
除了初始模块之外要解析的根模块。
< 模块名称 > 还可以为 ALL-DEFAULT, ALL-SYSTEM,
ALL-MODULE-PATH.
--list-modules
列出可观察模块并退出
-d <module name>
--describe-module < 模块名称 >
描述模块并退出
--dry-run 创建 VM 并加载主类, 但不执行 main 方法。
此 --dry-run 选项对于验证诸如
模块系统配置这样的命令行选项可能非常有用。
--validate-modules
验证所有模块并退出
--validate-modules 选项对于查找
模块路径中模块的冲突及其他错误可能非常有用。
-D< 名称 >=< 值 >
设置系统属性
-verbose:[class|module|gc|jni]
启用详细输出
-version 将产品版本输出到错误流并退出
--version 将产品版本输出到输出流并退出
-showversion 将产品版本输出到错误流并继续
--show-version
将产品版本输出到输出流并继续
--show-module-resolution
在启动过程中显示模块解析输出
-? -h -help
将此帮助消息输出到错误流
--help 将此帮助消息输出到输出流
-X 将额外选项的帮助输出到错误流
--help-extra 将额外选项的帮助输出到输出流
-ea[:< 程序包名称 >...|:< 类名 >]
-enableassertions[:< 程序包名称 >...|:< 类名 >]
按指定的粒度启用断言
-da[:< 程序包名称 >...|:< 类名 >]
-disableassertions[:< 程序包名称 >...|:< 类名 >]
按指定的粒度禁用断言
-esa | -enablesystemassertions
启用系统断言
-dsa | -disablesystemassertions
禁用系统断言
-agentlib:< 库名 >[=< 选项 >]
加载本机代理库 < 库名 >, 例如 -agentlib:jdwp
另请参阅 -agentlib:jdwp=help
-agentpath:< 路径名 >[=< 选项 >]
按完整路径名加载本机代理库
-javaagent:<jar 路径 >[=< 选项 >]
加载 Java 编程语言代理, 请参阅 java.lang.instrument
-splash:< 图像路径 >
使用指定的图像显示启动屏幕
自动支持和使用 HiDPI 缩放图像
(如果可用)。应始终将未缩放的图像文件名 (例如, image.ext)
作为参数传递给 -splash 选项。
将自动选取提供的最合适的缩放
图像。
有关详细信息, 请参阅 SplashScreen API 文档
@argument 文件
一个或多个包含选项的参数文件
-disable-@files
阻止进一步扩展参数文件
--enable-preview
允许类依赖于此发行版的预览功能
要为长选项指定参数, 可以使用 --< 名称 >=< 值 > 或
--< 名称 > < 值 >。
补充内容: -server 与 -client
Hotspot JVM 有两种模式,分别是 server 和 client,分别通过 -server 和 -client 模式设置
- 32 位系统上,默认使用 Client 类型的 JVM。要想使用 Server 模式,机器配置至少有 2 个以上的 CPU 和 2G 以上的物理内存。client
模式适用于对内存要求较小的桌面应用程序,默认使用 Serial 串行垃圾收集器 - 64 位系统上,只支持 server 模式的 JVM,适用于需要大内存的应用程序,默认使用并行垃圾收集器
官网地址:https://docs.oracle.com/javase/8/docs/technotes/guides/vm/server-class.html
类型二:-X 参数选项
特点:
- 非标准化参数
- 功能还是比较稳定的。但官方说后续版本可能会变更
- 以
-X开头
直接在 DOS 窗口中运行 java -X 命令可以看到所有的 X 选项
- JDK 8
- JDK 21
D:\Java\jdk-1.8\bin>java -version
java version "1.8.0_381"
Java(TM) SE Runtime Environment (build 1.8.0_381-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.381-b09, mixed mode)
D:\Java\jdk-1.8\bin>java -X
-Xmixed 混合模式执行(默认)
-Xint 仅解释模式执行
-Xbootclasspath:< 用 ; 分隔的目录和 zip/jar 文件 >
设置引导类和资源的搜索路径
-Xbootclasspath/a:< 用 ; 分隔的目录和 zip/jar 文件 >
附加在引导类路径末尾
-Xbootclasspath/p:< 用 ; 分隔的目录和 zip/jar 文件 >
置于引导类路径之前
-Xdiag 显示附加诊断消息
-Xnoclassgc 禁用类垃圾收集
-Xincgc 启用增量垃圾收集
-Xloggc:<file> 将 GC 状态记录在文件中(带时间戳)
-Xbatch 禁用后台编译
-Xms<size> 设置初始 Java 堆大小
-Xmx<size> 设置最大 Java 堆大小
-Xss<size> 设置 Java 线程堆栈大小
-Xprof 输出 cpu 分析数据
-Xfuture 启用最严格的检查,预计会成为将来的默认值
-Xrs 减少 Java/VM 对操作系统信号的使用(请参阅文档)
-Xcheck:jni 对 JNI 函数执行其他检查
-Xshare:off 不尝试使用共享类数据
-Xshare:auto 在可能的情况下使用共享类数据(默认)
-Xshare:on 要求使用共享类数据,否则将失败。
-XshowSettings 显示所有设置并继续
-XshowSettings:system
(仅限 Linux)显示系统或容器
配置并继续
-XshowSettings:all
显示所有设置并继续
-XshowSettings:vm 显示所有与 vm 相关的设置并继续
-XshowSettings:properties
显示所有属性设置并继续
-XshowSettings:locale
显示所有与区域设置相关的设置并继续
-X 选项是非标准选项。如有更改,恕不另行通知。
D:\Java\jdk-21.0.2\bin>java -X
-Xbatch 禁用后台编译
-Xbootclasspath/a:< 以 ; 分隔的目录和 zip/jar 文件 >
附加在引导类路径末尾
-Xcheck:jni 对 JNI 函数执行其他检查
-Xcomp 强制在首次调用时编译方法
-Xdebug 不执行任何操作;已过时,将在未来发行版中删除。
-Xdiag 显示附加诊断消息
-Xfuture 启用最严格的检查,预期将来的默认值。
此选项已过时,可能会在
未来发行版中删除。
-Xint 仅解释模式执行
-Xinternalversion
显示比 -version 选项更详细的
JVM 版本信息
-Xlog:<opts> 配置或启用采用 Java 虚拟
机 (Java Virtual Machine, JVM) 统一记录框架进行事件记录。使用 -Xlog:help
可了解详细信息。
-Xloggc:<file> 将 GC 状态记录在文件中(带时间戳)。
此选项已过时,可能会在
将来的发行版中删除。它将替换为 -Xlog:gc:<file>。
-Xmixed 混合模式执行(默认值)
-Xmn<size> 为年轻代(新生代)设置初始和最大堆大小
(以字节为单位)
-Xms<size> 设置初始 Java 堆大小
-Xmx<size> 设置最大 Java 堆大小
-Xnoclassgc 禁用类垃圾收集
-Xrs 减少 Java/VM 对操作系统信号的使用(请参见文档)
-Xshare:auto 在可能的情况下使用共享类数据(默认值)
-Xshare:off 不尝试使用共享类数据
-Xshare:on 要求使用共享类数据,否则将失败。
这是一个测试选项,可能导致间歇性
故障。不应在生产环境中使用它。
-XshowSettings 显示所有设置并继续
-XshowSettings:all
显示所有设置并继续
-XshowSettings:locale
显示所有与区域设置相关的设置并继续
-XshowSettings:properties
显示所有属性设置并继续
-XshowSettings:vm
显示所有与 vm 相关的设置并继续
-XshowSettings:security
显示所有安全设置并继续
-XshowSettings:security:all
显示所有安全设置并继续
-XshowSettings:security:properties
显示安全属性并继续
-XshowSettings:security:providers
显示静态安全提供方设置并继续
-XshowSettings:security:tls
显示与 TLS 相关的安全设置并继续
-XshowSettings:system
(仅 Linux)显示主机系统或容器
配置并继续
-Xss<size> 设置 Java 线程堆栈大小
实际大小可以舍入到
操作系统要求的系统页面大小的倍数。
-Xverify 设置字节码验证器的模式
请注意,选项 -Xverify:none 已过时,
可能会在未来发行版中删除。
--add-reads <module>=<target-module>(,<target-module>)*
更新 <module> 以读取 <target-module>,而无论
模块如何声明。
<target-module> 可以是 ALL-UNNAMED,将读取所有未命名
模块。
--add-exports <module>/<package>=<target-module>(,<target-module>)*
更新 <module> 以将 <package> 导出到 <target-module>,
而无论模块如何声明。
<target-module> 可以是 ALL-UNNAMED,将导出到所有
未命名模块。
--add-opens <module>/<package>=<target-module>(,<target-module>)*
更新 <module> 以在 <target-module> 中打开
<package>,而无论模块如何声明。
--limit-modules <module name>[,<module name>...]
限制可观察模块的领域
--patch-module <module>=<file>(;<file>)*
使用 JAR 文件或目录中的类和资源
覆盖或增强模块。
--source <version>
设置源文件模式中源的版本。
--finalization=<value>
控制 JVM 是否执行对象最终处理,
其中 <value> 为 "enabled" 或 "disabled" 之一。
默认情况下,最终处理处于启用状态。
这些额外选项如有更改, 恕不另行通知。
对比 JDK 8 和 JDK 21 变化还是很大的。
JVM 的 JIT 编译模式相关的选项
-Xint: 只使用解释器:所有字节码都被解释执行,这个模式的速度是很慢的-Xcomp: 只使用编译器:所有字节码第一次使用就被编译成本地代码,然后在执行-Xmixed: 混合模式:这是默认模式,刚开始的时候使用解释器慢慢解释执行,后来让 JIT
即时编译器根据程序运行的情况,有选择地将某些热点代码提前编译并缓存在本地,在执行的时候效率就非常高了


JDK 默认使用的是混合模式
类型三:-XX 参数选项
特点:
- 非标准化参数
- 使用的最多的参数类型
- 这类选项属于实验性,不稳定
- 以
-XX开头
作用:用于开发和调试 JVM
Boolean 类型格式
-XX:+<option>表示启用 option 属性-XX:-<option>表示禁用 option 属性
举例
-XX:+UsePara1lelGC选择垃圾收集器为并行收集器-XX:+UseG1GC表示启用 G1 收集器-XX:+UseAdaptiveSizePolicy自动选择年轻代区大小和相应的 Survivor 区比例
非 Boolean 类型格式(key-value 类型)
- 子类型 1:数值型格式
-XX:<option>=<number> - 子类型 2:非数值型格式
-XX:<name>=<string>
-XX:+PrintFlagsFinal
- 输出所有参数的名称和默认值
- 默认不包括 Diagnostic 和 Experimental 的参数
- 可以配合 -XX:+UnlockDiagnosticVMOptions 和 -XX:UnlockExperimentalVMOptions 使用
D:\Java\jdk-21.0.2\bin>java -XX:+PrintFlagsFinal -version
[Global flags]
int ActiveProcessorCount = -1 {product} {default}
uintx AdaptiveSizeDecrementScaleFactor = 4 {product} {default}
uintx AdaptiveSizeMajorGCDecayTimeScale = 10 {product} {default}
uintx AdaptiveSizePolicyCollectionCostMargin = 50 {product} {default}
uintx AdaptiveSizePolicyInitializingSteps = 20 {product} {default}
uintx AdaptiveSizePolicyOutputInterval = 0 {product} {default}
uintx AdaptiveSizePolicyWeight = 10 {product} {default}
uintx AdaptiveSizeThroughPutPolicy = 0 {product} {default}
uintx AdaptiveTimeWeight = 25 {product} {default}
bool AggressiveHeap = false {product} {default}
bool AlignVector = false {C2 product} {default}
ccstr AllocateHeapAt = {product} {default}
...
4.2 添加 JVM 参数选项
IDEA



运行 jar 包
java -Xms50m -Xmx50m -XX:+PrintGCDetails -XX:+PrintGCTimeStamps -jar demo.jar
通过 Tomcat 运行 war 包
Linux 系统下可以在 tomcat/bin/catalina.sh 中添加类似如下配置:
JAVA_OPTS="-Xms512M -Xmx1024M"
Windows 系统下载 catalina.bat 中添加类似如下配置:
set "JAVA_OPTS=-Xms512M -Xmx1024M"
程序运行过程中
jinfo 不仅可以查看运行时某一个 Java 虚拟机参数的实际取值,甚至可以在运行时修改部分参数,并使之立即生效。
但是,并非所有参数都支持动态修改。参数只有被标记为 manageable 的 flag 可以被实时修改。其实,这个修改能力是极其有限的。
java -XX:+PrintFlagsFinal -version | findstr manageable 可以查看标记为 manageable 的参数
在本篇章的第二部分 《2. JVM 监控及诊断工具 - 命令行篇》
中有详细的讲解
- 使用
jinfo -flag <name>=<value> <pid>设置非 Boolean 类型参数 - 使用
jinfo -flag [+|-]<name> <pid>设置 Boolean 类型参数
4.3 常用的 JVM 参数选项
4.3.1 打印设置的 XX 选项及值
-XX:+PrintCommandLineFlags程序运行时 JVM 默认设置或用户手动设置的 XX 选项-XX:+PrintFlagsInitial打印所有 XX 选项的默认值-XX:+PrintFlagsFinal打印所有 XX 选项的实际值-XX:+PrintVMOptions打印 JVM 的参数
4.3.2 堆、栈、方法区等内存大小设置
栈
-Xss128k 等价于 -XX:ThreadStackSize,设置每个线程的栈大小为 128k
堆内存
-Xms3550m: 等价于-XX:InitialHeapSize,设置 JVM 初始堆内存为 3500M-Xmx3550m: 等价于-XX:MaxHeapSize,设置 JVM 最大堆内存为 3500M-Xmn2g: 设置年轻代大小为 2G,即等价于-XX:NewSize=2g -XX:MaxNewSize=2g,也就是设置年轻代初始值和年轻代最大值都是
2G。官方推荐配置为整 个堆大小的 3/8-XX:NewSize=1024m: 设置年轻代初始值为 1024M-XX:MaxNewSize=1024m: 设置年轻代最大值为 1024M-XX:SurvivorRatio=8: 设置年轻代中 Eden 区与一个 Survivor 区的比值,默认为 8-XX:+UseAdaptiveSizePolicy: 自动选择各区大小比例,默认开启-XX:NewRatio=2: 设置老年代与年轻代(包括 1 个 Eden 区和 2 个 Survivor 区)的比值,默认为 2-XX:PretenureSizeThreadshold=1024: 设置让大于此阈值的对象直接分配在老年代,单位为字节。只对 Serial、ParNew 收集器有效-XX:MaxTenuringThreshold=15: 默认值为 15。新生代每次 MinorGC 后,还存活的对象年龄 +1,当对象的年龄大于设置的这个值时就进入老年代-XX:+PrintTenuringDistribution: 让 JVM 在每次 MinorGC 后打印出当前使用的 Survivor 中对象的年龄分布-XX:TargetSurvivorRatio: 表示 MinorGC 结束后 Survivor 区域中占用空间的期望比例
方法区
| 参数 | 说明 | |
|---|---|---|
| 永久代 | -XX:PermSize=256m | 设置永久代初始值为 256M |
-XX:MaxPermSize=256m | 设置永久代最大值为 256M | |
| 元空间 | -XX:MetaspaceSize | 初始空间大小 |
-XX:MaxMetaspaceSize | 最大空间, 默认没有限制 | |
-XX:+UseCompressedOops | 使用压缩对象指针 | |
-XX:+UseCompressedClassPointers | 使用压缩类指针 | |
-XX:CompressedClassSpaceSize | 设置 Klass Metaspace 的大小,默认 1G |
直接内存
-XX:MaxDirectMemorySize: 指定DirectMemory容量,若未指定,则默认与Java堆最大值一样
4.3.3 OutOfMemory 相关的选项
| 参数 | 说明 |
|---|---|
-XX:+HeapDumpOnOutMemoryError | 内存出现 OOM 时生成 Heap 转储文件,两者互斥 |
-XX:+HeapDumpBeforeFullGC | 出现 FullGC 时生成 Heap 转储文件,两者互斥 |
-XX:HeapDumpPath=<path> | 指定 heap 转储文件的存储路径,默认当前目录 |
-XX:OnOutOfMemoryError=<path> | 指定可行性程序或脚本的路径,当发生 OOM 时执行脚本 |
对 OnOutOfMemoryError 的运维处理
以部署在 Linux 系统 /opt/Server 目录下的 Server.jar 为例
1.在run.sh启动脚本中添加jvm参数:
-XX:OnOutOfMemoryError=/opt/Server/restart.sh
2.restart.sh脚本
Linux环境:
#!/bin/bash
pid=$(ps -eflgrep Server.jarlawk '{if($8=-"java"){print $2}}')
ki11 -9 $pid
cd /opt/Server/;
sh run.sh
Windows环境:
echo off
wmic process where Name='java.exe' delete
cd D:\Server
start run.bat
-XX:+HeapDumpOnOutMemoryError (在出现 OOM 的时候生成 dump 文件) 和 -XX:+HeapDumpBeforeFullGC (在出现 Full GC 的时候生成 dump 文件) 只能设置 1 个,如果不设置 -XX:HeapDumpPath=<path>,那么将会在当前目录下生成 dump 文件,如果设置的话,将会在指定位置生成 dump 文件
4.3.4 垃圾收集器相关选项
7款经典收集器与垃圾分代之间的关系

垃圾收集器的组合关系

为什么要有很多收集器,一个不够吗?因为 Java 的使用场景很多,移动端,服务器等。所以就需要针对不同的场景,提供不同的垃圾收集器,提高垃圾收集的性能。
虽然我们会对各个收集器进行比较,但并非为了挑选一个最好的收集器出来。没有一种放之四海皆准、任何场景下都适用的完美收集器存在,更加没有万能的收集器。所以我们选择的只是对具体应用最合适的收集器。