如何在AWS Step Function顶层输入中添加States.Format输出（无需Lambda）

你遇到的问题是Step Functions完成数据查询后，需要把States.Format生成的结果添加到输入顶层，同时保留所有原有输入，且新字段不能嵌套在子对象里。之前尝试的几种Pass状态配置均未成功：

• 使用Result：仅支持静态字面量，无法解析States.Format表达式
• Parameters结合ResultPath：结果会被嵌套到子对象中
• 通过Parameters获取全部输入后添加新字段：生成异常键

下面是无需调用Lambda的解决方案：

解决方案：Pass状态配合Parameters展开语法+ResultPath #

核心思路是利用Step Functions的Parameters配置，通过"*": "$"语法展开原有输入的所有顶层字段，同时添加用States.Format生成的新字段，最后用ResultPath: "$"将合并后的对象作为新输入，覆盖原有内容。

关键配置说明 #

• "*": "$"：Step Functions的特殊语法，会将输入中的所有顶层键值对复制到新对象中，完整保留原有输入内容
• 新字段名.$：用带. $后缀的键引用表达式，这里就是States.Format的计算结果
• ResultPath: "$"：指定将Pass状态的输出直接替换整个输入，确保新字段处于顶层

完整状态机示例 #

假设你有一个数据查询状态（比如DynamoDB GetItem），后续接这个处理Pass状态：

{
  "Comment": "Add formatted top-level field without Lambda",
  "StartAt": "QueryData",
  "States": {
    "QueryData": {
      "Type": "Task",
      "Resource": "arn:aws:states:::dynamodb:getItem",
      "Parameters": {
        "TableName": "YourTargetTable",
        "Key": {
          "ID": { "S.$": "$.requestId" }
        }
      },
      "ResultPath": "$.queryResult",
      "Next": "AddFormattedResult"
    },
    "AddFormattedResult": {
      "Type": "Pass",
      "Parameters": {
        "*": "$",
        "formattedSummary.$": "States.Format('Query completed for ID {}: Value is {}', $.requestId, $.queryResult.Item.Value.S)"
      },
      "ResultPath": "$",
      "End": true
    }
  }
}

为什么之前的尝试失败？ #

1. Result字段限制：Result只能设置静态值，不支持解析表达式，所以无法直接用States.Format
2. ResultPath嵌套问题：如果之前设置ResultPath为$.someSubKey，结果自然会嵌套；若用ResultPath: "$"但没正确合并原有输入，会丢失原有字段
3. Parameters语法错误：如果之前直接写"$": "$"，会把原有输入作为一个名为$的字段，导致异常键；正确的展开语法是"*": "$"

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