ECS RunTask报错：必填字段TaskDefinition缺失但已配置

核心错误原因 #

你用Arguments字段传递ECS任务参数，但对于Step Functions的arn:aws:states:::ecs:runTask.sync资源，正确的参数容器是Parameters而非Arguments。Step Functions会忽略Arguments里的配置，导致系统判定你未指定TaskDefinition，从而抛出报错。

另外你的JSON配置存在语法错误：Environment数组、ContainerOverrides数组以及Overrides对象都未正确闭合，这也会导致配置解析失败。

修正后的完整配置示例 #

{
  "Type": "Task",
  "Resource": "arn:aws:states:::ecs:runTask.sync",
  "Parameters": {
    "TaskDefinition": "arn:xxxxxxxxx:6",
    "Cluster": "arn:xxxxxxxxx",
    "LaunchType": "FARGATE",
    // 补充FARGATE必填的NetworkConfiguration参数，示例如下：
    "NetworkConfiguration": {
      "AwsvpcConfiguration": {
        "Subnets": ["subnet-xxxxxx"],
        "SecurityGroups": ["sg-xxxxxx"],
        "AssignPublicIp": "ENABLED"
      }
    },
    "Overrides": {
      "ContainerOverrides": [
        {
          "Name": "buildPlots",
          "Environment": [
            {
              "Name": "NUM_USERS",
              "Value.$": "$.numUsers"
            },
            {
              "Name": "USER_IDS",
              "Value.$": "$.user_ids"
            }
          ]
        }
      ]
    }
  }
}

关键说明 #

1. 替换Arguments为Parameters：这是Step Functions调用ECS RunTask资源的标准参数传递方式，只有这样系统才能正确识别TaskDefinition、Cluster等核心参数。
2. 修复JSON语法：确保所有数组[]和对象{}都正确闭合，否则配置无法被正常解析。
3. 补充FARGATE必填项：使用FARGATE启动类型时，必须配置NetworkConfiguration参数（包含子网、安全组等信息），否则会触发额外报错。
4. 环境变量引用验证：Value.$的写法是正确的，用于从Step Functions输入中动态取值，需确保$.numUsers、$.user_ids与你的实际输入结构完全匹配。

之前你不使用Arguments/Parameters时报错消失，是因为Step Functions忽略了无效的参数结构，但同时也无法正确传递Overrides里的环境变量配置，导致变量无法生效。

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