RAG 服务 Docker 容器启动失败且疑似 OOM 时，优先检查宿主机内核日志 dmesg 而非容器标准输出日志，因为 OOM Killer 由内核触发。适用场景为容器瞬间退出且无应用层报错，风险边界在于调整内存限制前需确认宿主机物理内存余量。

命令速用版

以下命令用于快速定位 OOM 证据和查看内存配置，直接在宿主机终端执行。

# 查看容器退出码
docker inspect `--format`='{{.State.ExitCode}}' <容器 ID 或名称>

# 检索内核 OOM 日志
dmesg | grep -i 'out of memory'

# 查看容器内存限制
docker inspect `--format`='{{.HostConfig.Memory}}' <容器 ID 或名称>

# 实时观察内存使用
docker stats <容器 ID 或名称>

为什么会这样

容器进程被内核 OOM Killer 强制终止时，应用层无法捕获信号写入日志，因此 docker logs 通常为空。

Linux 内核在系统物理内存不足时，会根据 oom_score 选择占用较高的进程杀死以保护系统稳定。RAG 服务在启动阶段加载 Embedding 模型或向量数据库索引时，内存占用会瞬间峰值，若超过 Docker 设置的 memory limit 或宿主机可用物理内存，内核会直接发送 SIGKILL 信号。容器退出码 137 等于 128 + 9，代表进程收到 SIGKILL 信号终止，这是 OOM 的典型特征。

分步处理

按顺序执行以下步骤，每一步都有明确的检查点，避免盲目调整配置。

步骤 1：确认退出码

执行 docker inspect 命令查看 State.ExitCode。若返回 137，高度疑似 OOM；若返回 1 或 0，则可能是应用逻辑错误或正常退出，需转而检查 docker logs 中的应用报错。

步骤 2：检索内核日志

在宿主机执行 dmesg -T | grep -i 'kill' 或查看 /var/log/kern.log。寻找包含容器进程名或 PID 的 Out of memory kill 记录。若日志显示 Killed process xxx (python/java)，则确认为内存不足。

步骤 3：检查内存限制

使用 docker inspect 查看 HostConfig.Memory 值。若值为 0 表示无限制，受宿主机物理内存约束；若为具体数值，表示容器硬限制。RAG 服务建议预留模型加载峰值的 1.5 倍内存余量。

步骤 4：调整配置或优化

若宿主机内存充足，启动容器时增加 `--memory` 参数。若宿主机内存紧张，需优化 RAG 服务配置，例如减小 Embedding 模型维度、降低向量数据库索引缓存大小或启用模型量化。

怎么验证是否生效

调整配置后重启容器，观察容器状态和内存曲线。

执行 docker ps 确认容器状态为 Up 且持续运行超过 5 分钟。执行 docker stats 观察内存使用率是否稳定在限制值以内，无剧烈波动触顶。再次检查 dmesg 日志，确认启动时间段内无新的 OOM kill 记录。

常见坑

排查过程中容易忽略以下场景，导致问题重复出现。

Java 服务堆内存设置不当

Java 应用运行在容器中时，JVM 默认可能根据宿主机总内存而非容器限制计算堆大小。需在启动参数中显式设置 -Xmx，确保堆内存小于 Docker 内存限制，预留非堆内存空间。

向量数据库索引构建峰值

向量数据库在初始化或写入索引时内存占用远高于查询时。若仅在空闲时调整内存，可能在数据导入阶段再次触发 OOM。建议在数据构建阶段临时调高内存限制。

Swap 交换分区干扰

宿主机开启 Swap 可能延缓 OOM 触发，但会导致系统严重卡顿。若 dmesg 未见 OOM 但系统负载极高，检查 free -h 确认 Swap 使用情况，必要时关闭 Swap 或调整 swappiness 参数。

常见问题

容器退出码 137 一定是 OOM 吗？

绝大多数情况下是 OOM，但也可能是手动执行 docker kill 发送了 SIGKILL 信号。需结合 dmesg 内核日志确认是否有 Out of memory 记录来区分。

docker logs 没有任何输出怎么办？

OOM 发生时进程被内核直接杀死，无法刷新缓冲区日志。此时应放弃查看容器日志，转而检查宿主机 dmesg 或 /var/log/syslog 中的内核消息。

增加内存限制后仍然启动失败？

可能是宿主机物理内存本身不足，而非容器限制过低。检查 free -h 确认宿主机可用内存，或检查是否还有其他容器争抢资源，必要时迁移服务至更高配置节点。