Java / 系统课时

搭建可复现的 JVM 实验环境

搭建可复现的 JVM 实验环境

这一课搭一套可以反复启动、施加相同内存负载并留下 GC 证据的最小实验环境。完成后,你可以只修改一个 JVM 参数重新运行,用同一份请求负载比较 GC 次数、停顿和堆行为,而不是靠一次性的手工操作得出结论。示例环境需要 JDK 21、Bash、curl 与 xargs。

学习目标

  • 构造一个无第三方依赖、会稳定产生短命与存活对象的 Java 服务
  • 固定 JDK 路径、堆大小、收集器、线程数和 GC 日志参数
  • 使用固定请求数与并发度复现实验,并验证 GC 日志确实产生

先固定实验变量

可复现不等于“每次毫秒数完全一样”,而是输入条件足够稳定,使差异可以解释。至少固定 JDK 构建、JVM 参数、服务代码、可用 CPU/内存、请求总数和并发度;比较两个方案时一次只改变一个变量。机器仍会有调度和缓存抖动,因此最终应比较多轮结果,而不是单次最小值。CPU 和内存限制应由同一台实验机、容器或虚拟机固定;资源条件变化时,应把它视为另一组基线。

可复现 JVM 实验环境的数据流

创建能持续制造分配压力的服务

下面的服务只使用 JDK 自带的 jdk.httpserver 模块。每次访问 /alloc 会分配约 8 MiB 字节数组,其中一小部分进入有上限的保留队列,从而同时制造短命对象和会存活一段时间的对象;队列上限避免它无限增长成纯粹的 OOM 测试。

将以下内容保存为 MemoryLab.java:

java
import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpServer;

import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.charset.StandardCharsets;
import java.util.ArrayDeque;
import java.util.Deque;
import java.util.concurrent.Executors;

public class MemoryLab {
    private static final Deque<byte[]> RETAINED = new ArrayDeque<>();
    private static final int RETAIN_LIMIT = 4096;

    public static void main(String[] args) throws Exception {
        int port = Integer.parseInt(System.getenv().getOrDefault("PORT", "8080"));
        HttpServer server = HttpServer.create(new InetSocketAddress(port), 0);
        server.createContext("/health", exchange -> respond(exchange, "ok\n"));
        server.createContext("/alloc", MemoryLab::allocate);
        server.setExecutor(Executors.newFixedThreadPool(4));
        server.start();
        System.out.println("listening on :" + port);
    }

    private static void allocate(HttpExchange exchange) throws IOException {
        long checksum = 0;
        for (int i = 0; i < 128; i++) {
            byte[] block = new byte[64 * 1024];
            block[0] = (byte) i;
            checksum += block[0];

            // 每 16 个块保留 1 个,制造可控的长期存活对象。
            if ((i & 15) == 0) {
                synchronized (RETAINED) {
                    RETAINED.addLast(block);
                    if (RETAINED.size() > RETAIN_LIMIT) {
                        RETAINED.removeFirst();
                    }
                }
            }
        }

        int retained;
        synchronized (RETAINED) {
            retained = RETAINED.size();
        }
        respond(exchange, "retained=" + retained + ",checksum=" + checksum + "\n");
    }

    private static void respond(HttpExchange exchange, String body) throws IOException {
        byte[] bytes = body.getBytes(StandardCharsets.UTF_8);
        exchange.sendResponseHeaders(200, bytes.length);
        exchange.getResponseBody().write(bytes);
        exchange.close();
    }
}

预期结果:

text
源码保存为 MemoryLab.java;使用 JDK 21 的 javac 编译后应无编译错误。

用固定启动脚本消除隐藏变量

实验脚本直接调用指定 JAVA_HOME,并拒绝 JDK_JAVA_OPTIONS、JAVA_TOOL_OPTIONS、_JAVA_OPTIONS 这三类可能偷偷注入 JVM 参数的环境变量。-Xms 与 -Xmx 都设为 512 MiB,是为了消除实验中的堆扩容变量;这不是生产环境必须照搬的配置。MaxGCPauseMillis=100 是 G1 的软目标,不是 100 ms 的硬性 SLA。

将下面内容保存为 run.sh:

bash
#!/usr/bin/env bash
set -euo pipefail

: "${JAVA_HOME:?请把 JAVA_HOME 指向固定的 JDK 21 安装目录}"

for name in JDK_JAVA_OPTIONS JAVA_TOOL_OPTIONS _JAVA_OPTIONS; do
  if [[ -n "${!name:-}" ]]; then
    echo "请先清空 $name,避免向实验注入隐藏 JVM 参数" >&2
    exit 1
  fi
done

mkdir -p logs
rm -f logs/gc.log logs/gc.log.*

"$JAVA_HOME/bin/javac" --add-modules jdk.httpserver MemoryLab.java

exec "$JAVA_HOME/bin/java" \
  --add-modules jdk.httpserver \
  -Xms512m \
  -Xmx512m \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=100 \
  '-Xlog:gc*,safepoint:file=logs/gc.log:time,uptime,level,tags:filecount=3,filesize=10m' \
  MemoryLab

预期输出:

text
listening on :8080

如果实际端口通过 PORT 环境变量修改,输出中的端口会相应变化。正式对比前应把 java -version 和这份脚本一并保存,确保不同轮次没有悄悄换 JDK 或 JVM 参数。

施加固定负载并确认 GC 证据

保持服务运行,在另一个 Linux 或 macOS 终端执行固定 2000 个请求、并发度 4 的负载。这里固定的是“总请求数 + 并发度”,目的不是追求最高 QPS,而是让每轮产生近似相同的分配总量。

bash
curl -fsS http://127.0.0.1:8080/health

printf '%s\n' {1..2000} | xargs -P4 -I{} curl -fsS http://127.0.0.1:8080/alloc -o /dev/null

tail -n 5 logs/gc.log

预期结果:

text
ok
[<TIME>][<VALUE>s][info][gc,start] GC(<ID>) Pause Young <VALUE>
[<TIME>][<VALUE>s][info][gc] GC(<ID>) Pause Young <VALUE> <VALUE>ms

GC 编号、时间、堆容量和停顿时长都属于动态值,实际内容会不同;验收重点是请求全部完成、服务仍健康,并且 logs/gc.log 中持续出现 GC 事件。若没有 GC 日志,先检查启动命令是否真的包含 -Xlog,再确认当前目录下的 logs 是否可写。

这套环境的价值在于“可重复改变一个条件”。例如下一轮只把 -XX:MaxGCPauseMillis=100 改为另一个值,其余代码、JDK、堆大小和负载保持不变,再比较日志;如果同时改堆大小、并发度和 GC 参数,就无法把结果变化归因到单一因素。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建可复现的 JVM 实验环境

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

登录哪都通