在AWS Step Functions中为ECS容器正确传递JSON输入值

前提确认：解析 Lambda 返回的 JSON 字符串 #

如果你的lambdaResult.body是JSON格式字符串（比如Lambda返回结构为{"body": "{\"productId\": \"123\", \"totalPrice\": 99.9}"}），必须先将其解析为JSON对象，否则后续JSONPath无法正确读取属性。可通过Step Functions内置函数States.JsonParse处理：

// 在Run ECS Task步骤的Input中预先解析
"Input": {
  "lambdaResult": {
    "body.$": "States.JsonParse($.lambdaResult.body)"
  }
}

或在后续引用时直接解析：States.JsonParse($.lambdaResult.body).productId

一、环境变量的正确配置 #

在Run ECS Task的Parameters中，通过Value.$指定JSONPath动态引用属性，需确保路径指向单个字符串/数值/布尔值（不能是对象或数组）。

正确配置示例 #

"Parameters": {
  "Cluster": "your-ecs-cluster-name",
  "TaskDefinition": "your-task-definition-arn",
  "Overrides": {
    "ContainerOverrides": [
      {
        "Name": "your-spring-boot-container-name",
        "Environment": [
          {
            "Name": "PRODUCT_ID",
            "Value.$": "$.lambdaResult.body.productId"
          },
          {
            "Name": "TOTAL_PRICE",
            "Value.$": "$.lambdaResult.body.totalPrice"
          }
        ]
      }
    ]
  }
}

若lambdaResult.body未预先解析，修改为：

"Value.$": "States.JsonParse($.lambdaResult.body).productId"

二、命令行参数的正确配置 #

Spring Boot容器的Command数组会直接作为应用启动参数，需通过Command.$结合States.Array函数动态生成参数数组。

正确配置示例 #

"Parameters": {
  "Cluster": "your-ecs-cluster-name",
  "TaskDefinition": "your-task-definition-arn",
  "Overrides": {
    "ContainerOverrides": [
      {
        "Name": "your-spring-boot-container-name",
        "Command.$": "States.Array('--product-id', $.lambdaResult.body.productId, '--total-price', $.lambdaResult.body.totalPrice)"
      }
    ]
  }
}

若lambdaResult.body未预先解析，修改为：

"Command.$": "States.Array('--product-id', States.JsonParse($.lambdaResult.body).productId, '--total-price', States.JsonParse($.lambdaResult.body).totalPrice)"

常见问题排查 #

• SCHEMA_VALIDATION_FAILED错误：检查JSONPath拼写是否正确，或确认lambdaResult.body是否已解析为JSON对象；Value.$必须指向单个值，不能是对象/数组。
• 收到JSONPath字符串而非实际值：这是因为未使用.$后缀，直接写"Value": "$.lambdaResult.body.productId"会传递字符串本身，必须用"Value.$"指定动态引用。
• Spring Boot参数接收：确保应用通过@Value注解或CommandLineRunner/ApplicationRunner正确读取命令行参数。

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