退出码137表示容器被SIGKILL(信号9)强制终止,Docker Desktop下最常见原因为VM内存不足触发OOM Killer,根源可能是VM默认内存分配小、多容器挤占或WSL2/HyperKit内存管理机制导致的隐蔽超限。

退出码 137 表示容器被 SIGKILL(信号 9)强制终止,Docker Desktop 环境下最常见原因是内存超限触发 OOM Killer —— 但和 Linux 服务器不同,Desktop 的资源限制更隐蔽、更易被误判。
docker inspect 显示 "OOMKilled": true 就一定是内存问题?
不一定。Docker Desktop 底层运行在轻量级 Linux VM(HyperKit 或 WSL2)中,OOMKilled 字段为 true 只说明该 VM 内的 cgroup 触发了 OOM,但根源可能不在你的应用本身:
- VM 自身内存分配不足:Docker Desktop 默认只给 VM 分配 2GB 内存(macOS)或依赖 WSL2 配置(Windows),即使容器
--memory=512m,VM 总内存不够也会连带杀容器 - 其他容器或后台进程挤占:比如同时跑多个 Node.js 容器 + PostgreSQL + Redis,VM 内存很快见底
- WSL2 的 swap 机制不可靠:Windows 上 WSL2 默认禁用 swap,OOM 发生时无法缓冲,比原生 Linux 更“脆”
- macOS 的 HyperKit 不汇报真实内存压力:
docker stats显示内存使用率很低,但 VM 已被内核标记为 high pressure
验证方式:在宿主机终端运行 docker system info | grep -i memory,检查 Total Memory 是否远低于你物理机内存;再进 VM 查真实水位:docker run --rm -it --privileged alpine cat /proc/meminfo | grep -E "MemAvailable|MemFree"。
为什么 docker logs 空空如也,但容器反复 Exit 137?
日志为空 ≠ 进程没启动,而是主进程在初始化阶段就因内存不足被秒杀,根本来不及输出任何内容。常见于:
- JVM 应用未调小堆:
-Xmx2g在 Docker Desktop 默认 2GB VM 下必然 OOM,哪怕容器 limit 设为1g,JVM 启动时元空间、直接内存、线程栈等堆外内存已超限 - Node.js V8 堆内存自动增长:未设
--max-old-space-size,V8 检测到可用内存后疯狂申请,触发 cgroup kill - Python 多进程 + NumPy:fork 时 copy-on-write 失效,内存瞬间翻倍
临时验证:加 --memory=1g --memory-swap=1g 强制关闭 swap,并在启动命令前加 sleep 1 &&,看是否能撑过初始化 —— 如果能,基本锁定是启动瞬时峰值超限。
如何在 Docker Desktop 中稳定复现并确认 OOM 场景?
别依赖 dmesg —— Docker Desktop 的 VM 日志不直通宿主机。正确路径是:
- 打开 Docker Desktop 设置 → Resources → Advanced,记下当前
Memory值(如 2.0 GiB) - 运行一个内存压测容器:
docker run --rm -m 1.8g progrium/stress --vm 1 --vm-bytes 1.7g --timeout 30s - 观察是否出现
Exited (137);如果没触发,说明实际可用内存比设置值还低(VM 开销占用) - 关键动作:在压测运行中,另开终端执行
docker exec -it <container-id> top -b -n1 | head -20</container-id>,看 RES 列是否逼近 limit
注意:Docker Desktop 的内存限制是硬上限,且不支持 memory_reservation 这类软限制,一旦超限就是立即 kill,没有 warning 阶段。
重启策略 restart: always 会让 Exit 137 容器无限循环?
会,但这是假象。Docker 会按指数退避重试(100ms → 200ms → 400ms…),看起来像“卡住”,实则是不断启动 → 瞬间 OOM → 退出 → 等待 → 再启动。此时 docker ps -a 里会看到大量 Exited (137) 记录,StartedAt 和 FinishedAt 时间差往往只有几百毫秒。
真正要做的不是调重启策略,而是砍内存用量:
- Java:加
-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0,禁用-Xmx - Node.js:加
--max-old-space-size=512 - 所有镜像:在
Dockerfile里显式写HEALTHCHECK NONE,避免健康检查额外开进程吃内存 - 终极手段:在 Docker Desktop 设置里把 VM 内存提到 4GB(macOS)或配置
.wslconfig(Windows)
复杂点在于:Docker Desktop 的内存限制既作用于容器,也约束整个 VM,而 VM 开销(约 300–500MB)不显示在任何容器监控里。你看到的“够用”,往往是错觉。


















