启动ECS任务时出现CannotStartContainerError该如何解决？

问题描述 #

我有一个基于FastAPI的应用，对应的Dockerfile如下：

FROM python:3.8

WORKDIR /usr/src/app

COPY . .

RUN pip install --no-cache-dir -r requirements.txt

CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "5000"]

该应用在本地运行正常，可通过8888端口访问。部署到AWS后，已在ECR创建仓库并推送镜像，创建了ECS集群与任务。任务容器默认硬内存限制为128 MiB，端口映射正确，但启动任务后状态变为STOPPED，报错：

CannotStartContainerError: Error response from daemon: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: container init was OOM-killed (memory limit too low?): unknown

解决方案 #

1. 提升ECS任务的内存限制 #

128MiB的内存配额对于Python+FastAPI应用来说普遍不足，尤其是当依赖包含如pandas、numpy这类内存占用较高的库时。

• 进入ECS控制台，编辑对应的任务定义
• 在容器配置中调高硬内存限制，建议先尝试512MiB或1GiB，后续可根据应用实际运行时的内存占用进一步调整
• 更新任务定义后重新部署任务，验证是否能正常启动

2. 优化Docker镜像以减少内存开销 #

通过镜像优化缩小体积、降低运行时内存消耗：

• 使用轻量Python基础镜像：替换python:3.8为python:3.8-slim（基于Debian精简版）或python:3.8-alpine（更小的Alpine系统，注意部分Python包可能需要额外安装编译依赖，如gcc、musl-dev）
• 采用多阶段构建：分离构建与运行阶段，只保留运行必需的文件，示例：

# 构建阶段：安装依赖
FROM python:3.8-slim AS builder
WORKDIR /usr/src/app
COPY requirements.txt .
RUN pip install --no-cache-dir --user -r requirements.txt

# 运行阶段：仅复制依赖和应用代码
FROM python:3.8-slim
WORKDIR /usr/src/app
COPY --from=builder /root/.local/lib/python3.8/site-packages /usr/local/lib/python3.8/site-packages
COPY app/ ./app/
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "5000"]

• 清理冗余文件：构建完成后删除requirements.txt、测试代码、临时构建文件等非必要内容

3. 调整Uvicorn配置降低内存使用 #

• 限制工作进程数：Uvicorn默认会根据CPU核心数创建多个工作进程，在内存受限环境可手动指定为1个进程：
  修改Dockerfile中的CMD为：

  CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "5000", "--workers", "1"]
  

• 使用高效事件循环：安装uvloop依赖（添加到requirements.txt），并在启动时指定--loop uvloop，提升性能的同时减少内存占用

4. 排查应用自身的内存占用 #

• 本地运行时使用memory_profiler或ps aux工具分析应用启动阶段的内存消耗，检查是否存在初始化时加载大量数据、创建大对象等导致内存飙升的情况
• 清理requirements.txt中未使用的依赖，移除不必要的包以减少内存占用

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