Docker Desktop容器OOMKilled主因是容器内存超限而非宿主机内存不足，根本在于WSL2总内存限制与容器--memory参数双重约束，且/tmpfs未设size、JVM未适配容器内存导致高频触发。
容器在 Docker Desktop 上被 OOMKilled，基本可以确定不是宿主机整体内存不足，而是容器自身触发了内核 OOM Killer——Docker Desktop（基于 Hyper-V 或 WSL2）对容器的内存限制比 Linux 主机更敏感，且默认资源分配偏保守。
docker inspect 显示 OOMKilled=true 就是确诊了
别绕弯子，直接执行：docker inspect <container_id> | grep -i "oom\|exit"
如果输出中同时出现 "OOMKilled": true 和 "ExitCode": 137，问题锁定为内存超限。Docker Desktop 的 cgroups v2 机制会严格执行 --memory 限制，哪怕你只多用几 MB。
- Windows 用户注意：Docker Desktop 默认只给 WSL2 分配 2GB 内存（可通过
Settings → Resources → Memory调整），这个上限会影响所有容器的总可用内存池 -
docker stats显示的MEM USAGE / LIMIT中的 LIMIT 是容器级限制，但实际受 WSL2 总内存压制；比如容器设了--memory=1g，但 WSL2 只有 1.5g，多个容器就容易争抢 - 别信
free -h在容器里看到的“空闲内存”——那是 WSL2 虚拟机的视图，和容器 cgroup 限制无关
tmpfs 挂载没设 size 是隐形炸弹
Docker Desktop 对 --tmpfs 默认不限大小，而 /dev/shm、/run 这类 tmpfs 目录一旦被应用狂写（比如 FFmpeg、TensorFlow 临时缓存），会直接吃掉容器内存配额，且不体现在 JVM 堆或 ps aux RSS 里。
- 检查方式：
docker exec -it <container> find /tmp /run /dev/shm -type d -exec du -sh {} \; 2>/dev/null | sort -hr | head -5 - 修复方法：启动时显式限制 tmpfs 大小，例如
--tmpfs /dev/shm:rw,size=64m或--tmpfs /run:rw,size=32m - Kubernetes 用户同理：确保
emptyDir配置了sizeLimit，否则默认无上限
JVM 应用在 Docker Desktop 上特别容易翻车
Java 进程默认按宿主机内存（即 WSL2 总内存）算堆大小，但容器限制远小于此。比如 WSL2 有 4GB，容器只给了 1GB，JVM 却可能自动设 -Xmx3g，结果一启动就 OOMKilled。
- 必须加参数：
-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0（JDK 8u191+ / JDK 10+） - 禁用旧方案：
-Xmx硬编码值（如-Xmx512m）在镜像里写死，不如用百分比适配不同环境 - 验证是否生效：进容器执行
java -XX:+PrintFlagsFinal -version | grep MaxRAM，确认MaxRAMPercentage生效且MaxHeapSize接近容器 limit × 0.75 - 非堆内存（Metaspace、CodeCache、direct buffer）也要留余量，别把 100% 都划给堆
docker run 启动时必须带 --memory 才算真正防护
Docker Desktop 不会自动给容器设内存上限，不加 --memory 就等于裸奔——JVM、Node.js、Python 进程都能把 WSL2 内存撑爆，最终触发全局 OOM Killer 杀掉整个 WSL2 实例（表现为 Docker Desktop 弹窗报错、所有容器消失）。
- 最低实践：
docker run -m 512m --memory-swap=512m（禁用 swap，避免延迟暴露问题） - 软限制有用但别依赖：
--memory-reservation=300m只在内存压力下起作用，不能防止硬超限 - 别用
--oom-kill-disable：在 Docker Desktop 上启用它需要--privileged，且等于放弃保护，风险极高 - 本地开发建议：用
docker-compose.yml固化配置，避免每次run忘记参数
最常被忽略的是 WSL2 总内存和容器 memory 限制的双重约束关系——调高容器 limit 前，先去 Docker Desktop 设置里把 WSL2 内存调够；否则再细的容器参数也白搭。
