如何在Docker容器中为AdoptOpenJDK版HyperGraphQL调整JVM堆大小

• 拉取你正在使用的adoptopenjdk/openjdk8镜像，启动临时容器进入交互终端：
  docker run --rm -it adoptopenjdk/openjdk8 bash
• 在容器终端内执行以下两个命令，可直接输出当前镜像内置JVM的默认堆配置：
  • 查询默认初始堆大小：java -XX:+PrintFlagsInitial -version | grep InitialHeapSize
  • 查询默认最大堆大小：java -XX:+PrintFlagsInitial -version | grep MaxHeapSize
• 命令输出的堆大小数值单位为字节，可自行换算为常见的MB/GB单位。
• 注意：AdoptOpenJDK 8 版本低于U131时，JVM完全不感知容器的cgroup内存限制，默认最大堆为宿主机物理总内存的1/4，如果未给容器设置内存上限、也没手动指定堆大小，JVM会直接按宿主机总内存计算可占用堆内存，极易出现容器内存超限被OOM Kill的问题。

设置堆大小的核心逻辑是：先明确为容器分配的内存上限，再在该上限内为JVM预留足够的非堆内存空间，避免堆内存挤占非堆需求导致OOM。

• 内存拆分原则：容器总分配内存 = JVM堆内存 + JVM非堆开销（包含元空间、线程栈、JIT编译缓存、网络通信使用的直接内存等）。对于HyperGraphQL这类常规web应用，非堆部分预留256M~512M即可满足运行需求。
• 分版本适配的配置方式：
  1. 若使用的AdoptOpenJDK 8版本 >= U191：
     这类版本已支持cgroup内存感知能力，不需要手动写死固定堆大小，在启动命令中加入以下参数即可实现动态适配：
     • 解锁实验阶段的容器感知参数：-XX:+UnlockExperimentalVMOptions
     • 开启cgroup内存限制识别能力：-XX:+UseCGroupMemoryLimitForHeap
     • 自定义堆内存占容器总内存的比例：比如预留30%内存给非堆开销，就设置-XX:MaxRAMPercentage=70.0，既不会像默认配置那样只占用容器内存的1/4造成资源浪费，也不会把内存全部占满挤占非堆空间。
  2. 若使用的AdoptOpenJDK 8版本 < U191：
     这类版本无成熟的cgroup内存感知能力，需要手动在启动命令中写死固定堆大小。比如为容器分配1G内存、预留256M非堆空间时，可将初始堆和最大堆统一设置为768M，避免堆动态扩缩带来的性能抖动：-Xms768m -Xmx768m

针对你当前的HyperGraphQL运行配置，若使用U191以上版本的JDK8，修改后的Dockerfile启动命令片段如下：

FROM adoptopenjdk/openjdk8
RUN curl https://www.hypergraphql.org/resources/hypergraphql-1.0.3-exe.jar --output hypergraphql-1.0.3-exe.jar
EXPOSE 8080
CMD ["java", "-XX:+UnlockExperimentalVMOptions", "-XX:+UseCGroupMemoryLimitForHeap", "-XX:MaxRAMPercentage=70.0", "-jar", "hypergraphql-1.0.3-exe.jar", "--config", "/config/config.json"]

避坑提示：不要不指定任何内存参数就直接运行，也不要把最大堆设置为和容器内存上限完全相等。非堆内存无限制时很容易突破总内存阈值，导致容器被内核终止。

内容的提问来源于stack exchange，提问作者Jaana