Docker环境下Tomcat出现Java堆内存溢出问题咨询

问题背景 #

Tomcat内存配置如下：

CATALINA_OPTS="${CATALINA_OPTS} -Xms64M -Xmx512M -XX:MaxPermSize=512M"

使用Java 11版本，在Docker环境运行数天后触发java.lang.OutOfMemoryError: Java heap space，但在物理主机上运行数月无此问题。Docker容器未设置内存限制，默认使用主机4G内存中的约3.7G，溢出发生时容器内存使用率仅30%，进程未被杀死。

核心结论 #

Docker的内存管理逻辑和物理主机存在差异，但你遇到的堆溢出问题，核心是JVM堆内存配置与容器内存限制的分层控制，而非容器内存管理本身的差异。

具体分析 #

1. JVM堆内存的独立控制 #

你设置的-Xmx512M是Java堆内存的硬上限，这个参数和Docker容器的总内存限制是两个完全独立的层面：

• 不管容器总内存有多大，JVM堆内存最多只能用到512M，一旦堆内对象无法被垃圾回收、占用空间达到这个上限，就会触发堆溢出错误。
• 物理主机上未出现问题，大概率是物理环境中业务负载、对象生命周期的差异，让垃圾回收能及时释放堆内存，而Docker容器内的场景导致堆内存无法有效回收（比如请求量突增、存在内存泄漏对象）。

2. Docker与物理主机的内存管理差异 #

Docker通过cgroups实现进程级的内存隔离，和物理主机的内存管理核心区别在于：

• 隔离边界：物理主机的内存是全局共享的，所有进程竞争使用；Docker为容器划定了内存使用上限（这里是3.7G），容器内所有进程（包括JVM）的总内存不能超过这个值，否则Docker会触发OOM Killer杀死容器内的进程。
• 感知逻辑：Java 11默认支持识别Docker容器的内存限制，但这只影响JVM在未手动设置Xmx时的自动堆大小调整。你已经手动指定了Xmx512M，所以JVM不会参考容器内存限制来调整堆大小。

3. 为什么容器未被杀死？ #

Docker的OOM Killer只有在容器总内存使用率超过限制时才会触发，而你的堆溢出只是JVM堆内存耗尽，容器总内存仅用了30%（远低于3.7G的限制），所以Docker不会干预，只会由JVM自身抛出堆溢出错误。

解决建议 #

• 调整JVM堆参数：根据容器内存限制合理设置Xmx，比如容器有3.7G内存，可以设置-Xmx3G（预留部分内存给堆外内存、元空间、容器内其他进程），同时将Xms设为和Xmx相同的值，避免JVM频繁进行堆扩容。
• 启用容器内存感知：确保-XX:+UseContainerSupport参数开启（Java 11默认开启），如果不手动设置Xmx，JVM会自动根据容器内存限制调整堆大小（一般为容器内存的1/4到1/2）。
• 排查内存泄漏：生成并分析JVM堆dump文件，定位导致堆内存耗尽的对象，排查业务代码中是否存在内存泄漏场景。

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