Linux下Docker容器未达内存上限却触发SIGKILL错误的解决方法

1. 排查宿主机OOM Killer日志 #

Linux系统的OOM Killer会在**整体内存（含页缓存、swap等）**紧张时主动终止进程，哪怕docker stats显示还有剩余内存。执行以下命令确认：

dmesg | grep -i oom-killer
# 或查看系统日志
cat /var/log/syslog | grep -i oom

如果找到对应容器进程被终止的记录，说明是宿主机整体内存资源不足导致，而非容器自身限制。

2. 检查Docker守护进程全局内存限制 #

Docker默认可能存在全局内存限制，查看配置文件：

cat /etc/docker/daemon.json

如果存在"memory"或"mem_limit"字段，调整或删除该配置后重启Docker：

systemctl restart docker

3. 显式解除容器内存与swap限制 #

即使未设置内存限制，容器的swap限制可能导致内存+swap总和触发阈值。启动容器时显式关闭限制：

docker run --memory=-1 --memory-swap=-1 your-image-name

--memory=-1表示无内存限制，--memory-swap=-1表示swap无限制（需宿主机已开启swap）。

4. 检查宿主机swap配置 #

若宿主机swap未开启或容量过小，容器内存占用触达物理内存临界值时会触发OOM。查看swap状态：

swapon --show

若swap不足，可临时添加swap文件：

# 创建16GB swap文件
fallocate -l 16G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

需永久生效则将/swapfile none swap sw 0 0添加到/etc/fstab。

5. 监控应用启动阶段内存突增 #

部分应用启动时会短时间内存突增，超出宿主机瞬时承载能力。用以下命令实时监控容器启动过程：

docker stats --no-stream your-container-name

或进入容器内部查看进程内存占用：

docker exec -it your-container-name htop

6. 检查Docker cgroup内存配置 #

Docker通过cgroup管理资源，确认容器的cgroup内存限制：

# 获取容器ID
docker ps -qf "name=your-container-name"
# 查看cgroup内存上限
cat /sys/fs/cgroup/memory/docker/<容器ID>/memory.limit_in_bytes

如果返回值远小于宿主机可用内存，说明存在隐式限制，需排查Docker daemon或宿主机cgroup全局配置。

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