如何将Lambda返回的JSON字符串数组转为Step Functions Map可用数组？

核心问题定位 #

你遇到的无效JSONPath格式错误，大概率是在错误位置使用States.StringToJson，或是JSONPath语法不符合Step Functions规范导致的。Step Functions内置函数不能直接嵌套在ItemsPath这类字段中，必须先通过Pass状态完成转换。

具体解决方案 #

1. 用Pass状态完成字符串转JSON数组

先通过一个Pass状态，将Lambda返回的body字段（字符串化的数组）转换成原生JSON数组，再传递给Map组件处理。

示例状态机片段：

{
  "States": {
    "InvokeLambda": {
      "Type": "Task",
      "Resource": "arn:aws:lambda:REGION:ACCOUNT_ID:function:YOUR_LAMBDA_FUNCTION",
      "Next": "ConvertStringToJson"
    },
    "ConvertStringToJson": {
      "Type": "Pass",
      "Parameters": {
        "parsedCollection.$": "States.StringToJson($.body)"
      },
      "ResultPath": "$.converted",
      "Next": "ProcessWithMap"
    },
    "ProcessWithMap": {
      "Type": "Map",
      "ItemsPath": "$.converted.parsedCollection",
      "ItemProcessor": {
        "ProcessorConfig": {
          "Mode": "INLINE"
        },
        "States": [
          {
            "Type": "Pass",
            "End": true,
            "Parameters": {
              "item.$": "$"
            }
          }
        ]
      },
      "End": true
    }
  }
}

2. 排查字符串有效性

如果转换仍报错，先确认Lambda返回的body是合法的JSON数组字符串：

• 检查是否存在多余转义字符（比如Lambda返回时是否被二次JSON序列化）
• 查看Step Functions执行日志中InvokeLambda步骤的输出，确认body格式是否标准（例如是否为"[{\"id\":1}, {\"id\":2}]"这类格式）

3. 特殊情况：双重转义的处理

若发现body被双重序列化（比如API网关额外做了一次JSON转换），可嵌套使用两次States.StringToJson：

"parsedCollection.$": "States.StringToJson(States.StringToJson($.body))"

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