AWS ECS部署容器遇OCI runtime错误：args must not be empty求助

错误信息 #

CannotStartContainerError: ResourceInitializationError: failed to create new container runtime task: failed to create shim task: OCI runtime create failed: runc create failed: args must not be empty: unknown:

核心排查方向与解决方案 #

1. 检查ECS任务定义的命令配置冲突 #

ECS任务定义的EntryPoint和Command配置优先级高于Dockerfile，若存在空值或冲突会直接导致启动参数异常：

• 打开ECS任务定义的容器配置，确认Command字段要么完全移除（使用Dockerfile的ENTRYPOINT配置），要么配置为有效的参数数组（如传递给start.sh的参数）。
• 避免在任务定义中同时设置EntryPoint和空Command，ECS合并配置时会将空值视为无效启动参数。

2. 替换ENTRYPOINT中的相对路径为绝对路径 #

本地环境的WORKDIR解析逻辑与ECS容器初始化环境可能存在差异，将Dockerfile中的ENTRYPOINT改为绝对路径：

ENTRYPOINT [ "/bin/sh", "/home/node/app/start.sh" ]

3. 确保start.sh脚本的有效性 #

• 在脚本开头添加shebang头，明确指定解释器：

  #!/bin/sh
  echo "启动服务日志输出"
  # 你的环境变量设置与Node服务启动逻辑
  export NODE_ENV=production
  node dist/index.js
  

• 本地验证：执行docker run --rm your-image-name /bin/sh /home/node/app/start.sh，确认脚本能正常执行并输出日志。

4. 排查任务定义的用户权限配置 #

Dockerfile中已将目录权限设置为node:node，若ECS任务定义的User字段设置为root或其他非node用户，可能导致脚本无法访问。建议移除任务定义中的User配置，使用Dockerfile默认的用户环境。

5. 验证任务定义的JSON格式 #

确保任务定义的容器配置中，entryPoint和command字段格式正确，避免空数组或字符串格式错误：

"containerDefinitions": [
  {
    "name": "your-container-name",
    "image": "your-image-uri",
    "entryPoint": ["/bin/sh", "/home/node/app/start.sh"],
    // 移除command字段或配置有效参数
    ...
  }
]

额外验证步骤 #

• 用相同任务定义部署官方node:16镜像，执行echo "test"命令，确认ECS环境本身无问题。
• 检查ECS任务的CloudWatch日志组，确认是否有隐藏的权限或路径错误日志（可能在容器初始化阶段输出）。

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