一句话结论:
基础 Spring Boot 项目,Docker 内存给 512MB 可以跑;测试/小流量建议 512MB~768MB;生产环境建议 768MB~1GB 起步。不要把容器给的 512MB 全部配成 JVM 的 -Xmx512m,很容易被 Docker/K8s OOMKilled。
这里的“基础 Spring Boot 项目”指:一个内嵌 Tomcat、几个 REST 接口、少量 starter,没有大数据处理、大缓存、文件上传、WebSocket 长连接、大量定时任务这类重负载。
常见推荐值
| 场景 | Docker 内存限制 | JVM 堆建议 | 说明 |
|---|---|---|---|
| 本地 demo / 简单接口 | 512MB | -Xmx256m 左右 |
能跑,适合开发环境 |
| 测试环境 / 低并发服务 | 512MB~768MB | -Xmx256m~384m |
比较稳妥 |
| 生产基础 REST 服务 | 768MB~1GB | -Xmx384m~640m |
推荐起步值 |
| Spring Cloud / 网关 / 高并发 | 1GB 起 | 压测定 | 需要结合线程数、连接池、缓存来算 |
如果只能选一个默认值:
基础生产服务给 1GB,比较省心。
资源紧张但服务很简单,给 512MB,也能跑。
为什么不是“512MB 容器就配 512MB 堆”
Docker 的 --memory 限制的是整个容器进程可用的内存,不只是 Java 堆。
一个 Spring Boot 进程大致包括:
Java Heap
Metaspace / 方法区
Thread Stack
JIT Code Cache
Direct Buffer
GC 结构
JVM 自身 native 内存
日志缓冲、NIO buffer、类加载开销
所以如果你这样配:
docker run -m 512m ...
然后又设置:
-Xms512m -Xmx512m
基本就是在赌。堆刚起来,非堆、线程栈、元空间再加一点,容器就可能直接被杀掉。
更合理的做法是:堆只用容器内存的 50%~65%,剩下的留给 JVM 自身和运行时开销。
推荐配置方式一:用 MaxRAMPercentage
Java 10+,以及较新的 Java 8u 版本,JVM 基本都能感知容器内存限制。可以用:
docker run -d
--name demo-app
--memory=768m
--memory-swap=768m
-e JAVA_TOOL_OPTIONS="-XX:MaxRAMPercentage=55 -XX:InitialRAMPercentage=25 -XX:+ExitOnOutOfMemoryError"
-p 8080:8080 your-springboot-image:tag
含义:
容器总内存:768MB
最大堆:约 768 * 55% ≈ 422MB
初始堆:约 768 * 25% ≈ 192MB
剩余内存:给 Metaspace、线程栈、Direct Buffer、JIT、JVM native 等
如果是 1GB 容器,可以这样:
-XX:InitialRAMPercentage=30
-XX:MaxRAMPercentage=60
对应最大堆大约 600MB,比较适合普通生产 API 服务。
推荐配置方式二:直接写死 Xms/Xmx
如果你喜欢明确控制,也可以直接写死。
512MB 容器
-Xms128m -Xmx256m
768MB 容器
-Xms256m -Xmx384m
或者激进一点:
-Xms256m -Xmx448m
1GB 容器
-Xms256m -Xmx512m
或者:
-Xms256m -Xmx640m
我个人更偏向生产环境用 MaxRAMPercentage,因为容器规格调整后少改配置。但如果服务规模稳定,写死 Xms/Xmx 也很常见。
Docker Compose 示例
services:
app:
image: your-springboot-image:tag
ports:
- "8080:8080"
environment:
JAVA_TOOL_OPTIONS: "-XX:MaxRAMPercentage=55 -XX:InitialRAMPercentage=25 -XX:+ExitOnOutOfMemoryError"
mem_limit: 768m
memswap_limit: 768m
如果是 K8s,对应就是:
resources:
requests:
memory: "512Mi"
limits:
memory: "768Mi"
国内云上的 ACK、TKE、CCE 同理:requests 可以低一些,limits 要保证启动峰值和业务峰值都能扛住。
实际怎么判断够不够
别只凭感觉,直接看数据。
1. 看容器内存
docker stats
重点看:
MEM USAGE / LIMIT
如果长期贴近 limit,或者启动时打满,说明内存偏紧。
2. 看是否被杀
docker inspect container_id | grep OOMKilled
或者看容器事件:
docker events
如果是 OOMKilled,基本就是容器内存限制太小,或者 JVM 堆配太大。
3. 看 JVM 内存和 GC
可以开 Actuator:
/actuator/metrics/jvm.memory.used
/actuator/metrics/jvm.memory.max
/actuator/metrics/jvm.gc.pause
如果看到频繁 Full GC、RT 抖动、内存长期不回落,就要检查堆大小和业务代码。
我的实际建议
如果你现在只是想跑起来:
Docker 内存:512MB
JVM 最大堆:256MB
如果你想比较稳:
Docker 内存:768MB
JVM 最大堆:384MB~448MB
如果是生产基础服务:
Docker 内存:1GB
JVM 最大堆:512MB~600MB
最简单的落地方案:
docker run -d
--memory=768m
--memory-swap=768m
-e JAVA_TOOL_OPTIONS="-XX:MaxRAMPercentage=55 -XX:InitialRAMPercentage=25 -XX:+ExitOnOutOfMemoryError"
-p 8080:8080 your-springboot-image:tag
这个配置跑普通 Spring Boot API 服务,基本比较舒服。
云服务器