valentinomiazzo/jvm-memory-test

概述

该Docker镜像旨在实验Docker资源约束以及JVM应用可能出现的多种内存泄漏方式，帮助用户理解JVM内存管理与容器资源限制之间的关联。

核心功能

• 持续输出JVM内存使用统计（通过JVM诊断工具jcmd）
• 支持模拟堆、直接缓冲区、原生内存、类、线程等多种类型的JVM内存泄漏
• 展示容器资源限制（如内存）对JVM运行的影响（如被容器杀死或抛出异常）
• 对比Docker统计数据与JVM内部内存统计的差异

使用场景

• 学习JVM内存泄漏的表现形式与排查方法
• 测试容器资源限制下JVM的行为边界
• 验证JVM内存参数配置与容器资源的匹配性

配置说明

支持通过环境变量调整实验参数，主要变量包括：

• ALLOC_HEAP_MB：每次循环泄漏的堆内存大小（MB，默认周期1秒）
• MAX_HEAP_SIZE_MB：JVM堆内存最大值（MB）

部署示例

首次运行

sh
docker run -it valentinomiazzo/jvm-memory-test

持续打印jcmd输出的JVM内存统计信息，示例输出：

Native Memory Tracking:

Total: reserved=1348MB, committed=17MB
-                 Java Heap (reserved=64MB, committed=2MB)
                            (mmap: reserved=64MB, committed=2MB)

-                     Class (reserved=1032MB, committed=5MB)
                            (classes #414)
                            (mmap: reserved=1032MB, committed=5MB)

-                    Thread (reserved=6MB, committed=6MB)
                            (thread #11)
                            (stack: reserved=6MB, committed=6MB)

-                      Code (reserved=244MB, committed=3MB)
                            (mmap: reserved=244MB, committed=2MB)

-                    Symbol (reserved=1MB, committed=1MB)
                            (malloc=1MB #103)

在另一个终端查看容器资源使用：

sh
docker stats $(docker ps -l -q)

模拟堆内存泄漏（容器OOM杀死进程）

sh
docker run -it --memory=64m --memory-swap=64m --env ALLOC_HEAP_MB=1 --env MAX_HEAP_SIZE_MB=256 valentinomiazzo/jvm-memory-test

容器内存限制64MB（无交换空间），JVM堆最大256MB，运行后容器会因内存超限被杀死，验证：

sh
docker inspect -f '{{json .State}}' $(docker ps -l -q)

输出包含 "OOMKilled":true。

模拟堆内存泄漏（JVM抛出异常）

sh
docker run -it --memory=64m --memory-swap=64m --env ALLOC_HEAP_MB=1 --env MAX_HEAP_SIZE_MB=32 valentinomiazzo/jvm-memory-test

JVM堆最大32MB，耗尽时抛出OutOfMemoryError，容器不会被杀死，验证：

sh
docker inspect -f '{{json .State}}' $(docker ps -l -q)

输出包含 "OOMKilled":false。

支持的泄漏类型

镜像支持以下泄漏类型（详细变量见Dockerfile）：

• 堆内存泄漏
• 直接缓冲区泄漏
• 原生内存泄漏（通过sun.misc.Unsafe.allocateMemory()）
• 类泄漏
• 线程泄漏

构建镜像

sh
# 假设仓库已克隆到jvm-memory-test目录
docker build -t valentinomiazzo/jvm-memory-test jvm-memory-test