如何为jar包形式运行的Java Spring Boot应用设置物理内存限制

Spring Boot应用的总内存占用不止JVM堆内存，还包含元空间、JIT编译缓存、线程栈、NIO直接内存、GC自身开销、JNI调用申请的堆外内存等部分，仅配置堆内存参数无法严格控制总内存，需要结合JVM主动约束+进程级硬限额两层配置，才能实现类似容器的固定内存管控效果，满足myapp.jar总内存不超过400MB的要求。

1. 前置配置：JVM层面内存参数约束 #

这层配置的作用是让JVM主动将自身内存控制在目标范围内，是所有限额方案的基础，避免进程无意义申请内存触发系统级OOM。针对400MB总内存的场景，参考启动命令如下：

java -Xms300m -Xmx300m \
  -XX:MaxMetaspaceSize=60m \
  -XX:MaxDirectMemorySize=20m \
  -Xss256k \
  -XX:+UseSerialGC \
  -jar myapp.jar

参数说明：

• -Xms/-Xmx：设置JVM堆内存初始值、最大值，400MB总内存场景下堆内存建议分配280-320MB，给非堆内存留足余量，两个值设为一致可以避免运行时动态扩堆带来的性能开销
• -XX:MaxMetaspaceSize：限制元空间最大占用，普通带内置Tomcat的Spring Boot应用设置50-80MB即可，不配置的话元空间会随类加载动态扩容，很容易突破总内存预期
• -XX:MaxDirectMemorySize：限制NIO直接内存占用，无特殊NIO依赖的普通Web应用设置10-30MB即可
• -Xss：设置单个线程栈大小，JDK默认值为1MB，普通Web应用下调到256k不会影响正常运行，还能大幅降低高并发场景下的栈内存总占用
• GC选型：400MB这类小内存场景优先选择SerialGC，内存开销远低于G1、ZGC等面向大内存设计的垃圾回收器，能省出几十MB的额外内存空间

注意：仅配置JVM参数无法做到100%严格的内存硬限制，极端场景下（比如第三方JNI组件申请堆外内存、JVM自身临时内存开销）仍可能突破预期内存值。

2. 进程级硬限额：实现类容器的内存隔离效果 #

这层配置是从操作系统层面给进程设置物理内存硬上限，不管进程通过什么方式申请内存，超过限额都会触发内核管控，和容器的内存限制逻辑完全一致，根据运行环境可选以下方案：

2.1 Linux系统：基于cgroups的原生限制 #

容器技术的内存限制底层就是调用Linux内核的cgroups能力，不需要安装Docker等容器运行时，直接给Jar进程配置即可：

1. 创建专属内存控制组，设置400MB硬限额：

# 创建cgroup控制组
cgcreate -g memory:myapp_limit
# cgroup v2版本（主流新发行版默认）设置400MB内存上限
cgset -r memory.max=400M myapp_limit
# 如果是cgroup v1的老版本系统，替换为以下命令
# cgset -r memory.limit_in_bytes=400M myapp_limit
# 可选：设置350MB为软阈值，超过后内核会提前触发内存回收
cgset -r memory.high=350M myapp_limit

2. 在该控制组内启动myapp.jar：

cgexec -g memory:myapp_limit java [上述JVM启动参数] -jar myapp.jar

• 效果说明：进程总物理内存一旦触达400MB硬上限，内核会先强制回收内存，回收不到足够空间就会触发OOM杀死进程，完全符合固定物理内存限额的要求。
• systemd服务场景：如果用systemd管理应用开机自启，不需要手动操作cgroups，直接在service配置文件中添加MemoryMax=400M配置项即可，systemd会自动完成cgroup规则绑定。

坑点提示：JDK8u191之前的旧版本不会自动感知cgroup内存限制，需要额外添加JVM参数-XX:+UseCGroupMemoryLimitForHeap，否则JVM会读取宿主机总内存计算默认堆大小，大概率会触发cgroup OOM被杀死。

2.2 Windows系统：基于Job Object的原生限制 #

Windows平台可以通过系统内核自带的作业对象（Job Object）给进程设置内存硬上限，可直接使用轻量工具Process Governor启动应用，参考命令：

procgov --max-memory 400M -- java [上述JVM启动参数] -jar myapp.jar

2.3 轻量容器化方案（跨环境通用） #

如果不想手动配置系统规则，也可以用极简容器启动方式直接给Jar包套上内存限制，不需要提前打包镜像，直接挂载本地Jar包即可启动，以Docker为例：

docker run -d --name myapp \
  -m 400M --memory-swap 400M \
  -v $(pwd)/myapp.jar:/app/myapp.jar \
  openjdk:17-jre-slim \
  java [上述JVM启动参数] -jar /app/myapp.jar

• 参数-m 400M是给容器设置400MB物理内存硬上限，--memory-swap 400M是关闭磁盘交换分区使用，避免进程用磁盘swap冒充物理内存，完全匹配物理内存限额的要求。

配置验证 #

启动应用后可通过以下方式确认限额生效：

• 系统层面：Linux环境执行ps -o rss <java进程pid>查看进程实际驻留物理内存大小，也可查看对应cgroup的配置确认硬限额规则已绑定；Windows环境可通过任务管理器查看进程内存占用
• JVM层面：添加JVM启动参数-XX:NativeMemoryTracking=summary后，执行jcmd <java进程pid> VM.native_memory summary可查看JVM各模块的详细内存占用，确认各部分内存没有超过预设阈值

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