Java / 系统课时
调整堆上限与软上限
调整堆上限与软上限
本课解决 ZGC 堆空间“既要留突发余量,又不希望长期占满”的配置问题。你将区分 -Xmx 与 -XX:SoftMaxHeapSize,用同负载压测观察堆占用、GC 频率与尾延迟,再据此确定安全的硬上限和软目标。
学习目标
- 说明
-Xmx与SoftMaxHeapSize的作用边界,以及它们和进程 RSS 的区别。 - 设计只改变一个堆参数的压测,对比内存、GC、CPU 与尾延迟。
- 判断软上限是否压得过低,并能在运行中安全试调
SoftMaxHeapSize。
先分清硬上限和软上限
以下以 JDK 21 的 Generational ZGC 为可复现基线。-Xmx 是 Java 堆最大容量的硬边界:ZGC 不能把 Java 堆扩到这个值以上。它不是进程总内存上限,Metaspace、线程栈、Code Cache、直接内存以及 GC 自身的原生内存仍会占用额外 RSS。
-XX:SoftMaxHeapSize 是 ZGC 的软目标。ZGC 会尽量让堆容量和回收决策围绕这个值运行,但为了避免应用线程因分配等待回收,它可以临时超过软上限,最多仍受 -Xmx 约束。因此,SoftMax 不能替代 Xmx,更不能替代容器或主机的内存限制。

一个常见起点是让 Xmx 保留突发余量,再把 SoftMaxHeapSize 放在日常工作集之上。例如 Xmx=8g、SoftMax=6g 表示“平时尽量控制在约 6 GiB,必要时仍可使用到 8 GiB”。如果稳定存活对象本身就接近 6 GiB,这个软上限显然过紧。
用启动参数建立基线
片段示例:假设服务运行在 JDK 21,应用包路径与日志目录已存在。先用较保守的软上限启动 ZGC,并开启 GC 与 safepoint 日志。实际部署时将 <PATH> 替换为真实路径。
java \
-XX:+UseZGC \
-XX:+ZGenerational \
-Xms2g \
-Xmx8g \
-XX:SoftMaxHeapSize=6g \
-Xlog:gc*,safepoint:file=<PATH>/gc.log:time,uptime,level,tags \
-jar <PATH>/app.jar预期结果:
应用应正常启动,并在 <PATH>/gc.log 产生 GC 日志;具体业务启动日志由应用决定。这组配置的生效行为是:Java 堆最多增长到 8 GiB,ZGC 优先把 6 GiB 当作软目标。若使用 JDK 24 或更高版本,不要再传 -XX:+ZGenerational;这些版本的 ZGC 已只保留 generational 模式。
可以先用不依赖业务应用的命令验证关键 JVM 参数。下面的命令可直接在 JDK 21 环境执行。
java \
-XX:+UseZGC \
-XX:+ZGenerational \
-Xmx8g \
-XX:SoftMaxHeapSize=6g \
-XX:+PrintFlagsFinal \
-version 2>&1 \
| grep -E 'MaxHeapSize|SoftMaxHeapSize|UseZGC|ZGenerational'预期输出的关键行应等价于:
... MaxHeapSize ... = 8589934592 ...
... SoftMaxHeapSize ... = 6442450944 ...
... UseZGC ... = true ...
... ZGenerational ... = true ...其中 8 GiB 与 6 GiB 分别对应 8589934592 和 6442450944 字节;不同 JDK 构建的空格、flag 来源标记和输出顺序可能不同。
压测时只改一个变量
先确定 Xmx,再调软上限,不要同时改两个参数。确定 Xmx 时,固定流量模型、CPU 配额、JDK 构建、应用版本与 Xms,逐档比较不同 Xmx;目标是让“稳定存活集 + 并发回收期间的新分配”始终有足够余量,同时不过度占用宿主机内存。
固定 Xmx 后,再把 SoftMaxHeapSize 从接近 Xmx 的值逐步下调,例如在同一 8 GiB 硬上限下比较 8、6、5 GiB。每档都使用相同预热时间、测量时长和请求速率,并至少观察以下四组信号:
| 观察项 | 关注指标 | 软上限过低时的典型信号 |
|---|---|---|
| 内存 | heap used、committed、进程 RSS | 堆经常越过 SoftMax,RSS 并未明显下降 |
| GC | cycle 频率、并发 GC CPU、Allocation Stall | 回收更频繁,甚至出现分配停顿 |
| 延迟 | p99、p99.9、最大延迟 | 尾延迟随 GC 压力明显恶化 |
| 吞吐 | 固定 RPS 下的成功率或最大吞吐 | CPU 被 GC 抢占后可处理请求下降 |
不要只看“堆占用变小”就认为调优成功。若内存下降 15%,却换来明显更高的 GC CPU 或 p99.9 延迟,实际上只是把内存成本转成了计算和延迟成本。
在线试调 SoftMax
SoftMaxHeapSize 可以作为 manageable flag 在线调整,适合在同一 JVM、同一负载阶段做小步试探。为避免不同发行版对单位字符串解析的差异,下面直接使用字节数,把软上限改为 4 GiB。将 <PID> 替换为目标 JVM 的实际进程号。
jcmd <PID> VM.set_flag SoftMaxHeapSize 4294967296
jcmd <PID> VM.flags | grep SoftMaxHeapSize预期输出:
<PID>:
Command executed successfully.
... -XX:SoftMaxHeapSize=4294967296 ...修改后不要立刻用单个采样点下结论。至少跨过若干个完整负载周期,确认 GC 周期、分配停顿、CPU、p99/p99.9 和 RSS 的新稳态,再决定继续下调还是回退。-Xmx 则应视为启动期容量设计参数,不用在线试调思路替代容量规划。
避免两个常见误区
如果目标是让 ZGC 在低负载时归还未使用堆内存,就不要机械地设置 -Xms 等于 -Xmx;堆不会缩到 Xms 以下,二者相等会失去这部分弹性。相反,极端低延迟场景可能主动固定堆并预触页,以减少运行期提交和缺页带来的抖动,此时应接受更高的常驻内存。
另一个误区是把容器内存限制设成 SoftMaxHeapSize。软上限允许被突破,而且 JVM 还有大量非堆内存。生产配置应让容器或主机上限覆盖 Xmx 再加上经过实测的原生内存余量;否则 ZGC 即使遵守 Java 堆硬上限,进程仍可能被操作系统或容器直接终止。