AWS Step Function传参至ECS容器报JSONPath错误如何解决？

你传入Step Function的执行输入为数组结构，参数以{"name":"参数名","value":"参数值"}的形式存放在数组元素中，并非直接的{"参数名":"参数值"}键值对对象，因此$.S3_BUCKET这个JSONPath无法匹配到对应字段，触发报错。

你可以根据实际场景选择以下任意一种方案：

方案1：调整执行输入结构（最推荐） #

将Step Function的启动输入修改为直接的键值对格式，无需调整现有ECS参数覆盖规则即可正常运行：

{
  "S3_BUCKET": "test-bucket",
  "S3_KEY": "key-name.txt"
}

方案2：适配现有数组输入，修改JSONPath #

如果无法调整输入结构，可以修改ECS参数覆盖规则中的JSONPath，匹配数组中对应name的value值：

"Overrides": {
  "ContainerOverrides": [
    {
      "Name": "test",
      "Environment": [
        { "Name": "S3_BUCKET", "Value.$": "$[?(@.name == 'S3_BUCKET')].value[0]"},
        { "Name": "S3_KEY", "Value.$": "$[?(@.name == 'S3_KEY')].value[0]"}
      ]
    }
  ]
}

注：JSONPath过滤返回结果为数组，末尾加[0]是取第一个匹配到的参数值。

方案3：增加Pass状态预处理输入（稳定性最高） #

如果数组参数顺序固定，可以在调用ECS任务的状态前增加一个Pass状态，先把数组输入转换为键值对对象，后续所有参数引用都可以直接用$.参数名的格式：

"ConvertParams": {
  "Type": "Pass",
  "Parameters": {
    "S3_BUCKET.$": "$[0].value",
    "S3_KEY.$": "$[1].value"
  },
  "Next": "你的ECS任务状态名称"
}

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