Docker Desktop容器退出码137是什么原因_Docker Desktop容器异常终止排查

老丽吖_6521

老丽吖_6521

2026-11-05

378人浏览

原创

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

docker desktop容器退出码137是什么原因_docker desktop容器异常终止排查

退出码 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 top -b -n1 | head -20,看 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)不显示在任何容器监控里。你看到的“够用”,往往是错觉。

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

785

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6419

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

7517

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2973

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

339

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

491

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

460

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

325

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

525

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程