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,更不能替代容器或主机的内存限制。

ZGC 硬上限与软上限的关系

一个常见起点是让 Xmx 保留突发余量,再把 SoftMaxHeapSize 放在日常工作集之上。例如 Xmx=8g、SoftMax=6g 表示“平时尽量控制在约 6 GiB,必要时仍可使用到 8 GiB”。如果稳定存活对象本身就接近 6 GiB,这个软上限显然过紧。

用启动参数建立基线

片段示例:假设服务运行在 JDK 21,应用包路径与日志目录已存在。先用较保守的软上限启动 ZGC,并开启 GC 与 safepoint 日志。实际部署时将 <PATH> 替换为真实路径。

bash
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

预期结果:

text
应用应正常启动,并在 <PATH>/gc.log 产生 GC 日志;具体业务启动日志由应用决定。

这组配置的生效行为是:Java 堆最多增长到 8 GiB,ZGC 优先把 6 GiB 当作软目标。若使用 JDK 24 或更高版本,不要再传 -XX:+ZGenerational;这些版本的 ZGC 已只保留 generational 模式。

可以先用不依赖业务应用的命令验证关键 JVM 参数。下面的命令可直接在 JDK 21 环境执行。

bash
java \
  -XX:+UseZGC \
  -XX:+ZGenerational \
  -Xmx8g \
  -XX:SoftMaxHeapSize=6g \
  -XX:+PrintFlagsFinal \
  -version 2>&1 \
  | grep -E 'MaxHeapSize|SoftMaxHeapSize|UseZGC|ZGenerational'

预期输出的关键行应等价于:

text
... 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 的实际进程号。

bash
jcmd <PID> VM.set_flag SoftMaxHeapSize 4294967296
jcmd <PID> VM.flags | grep SoftMaxHeapSize

预期输出:

text
<PID>:
Command executed successfully.
... -XX:SoftMaxHeapSize=4294967296 ...

修改后不要立刻用单个采样点下结论。至少跨过若干个完整负载周期,确认 GC 周期、分配停顿、CPU、p99/p99.9 和 RSS 的新稳态,再决定继续下调还是回退。-Xmx 则应视为启动期容量设计参数,不用在线试调思路替代容量规划。

避免两个常见误区

如果目标是让 ZGC 在低负载时归还未使用堆内存,就不要机械地设置 -Xms 等于 -Xmx;堆不会缩到 Xms 以下,二者相等会失去这部分弹性。相反,极端低延迟场景可能主动固定堆并预触页,以减少运行期提交和缺页带来的抖动,此时应接受更高的常驻内存。

另一个误区是把容器内存限制设成 SoftMaxHeapSize。软上限允许被突破,而且 JVM 还有大量非堆内存。生产配置应让容器或主机上限覆盖 Xmx 再加上经过实测的原生内存余量;否则 ZGC 即使遵守 Java 堆硬上限,进程仍可能被操作系统或容器直接终止。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

调整堆上限与软上限

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通