AWS Step Functions Map任务无法获取原始事件参数值的问题

问题场景 #

当前在Serverless.yml中定义的Step Functions Map状态如下：

CreateQuestions:
            Type: Map
            ItemsPath: "$.data.questions"
            Iterator:
              StartAt: CreateQuestion
              States:
                CreateQuestion:
                  Type: Task
                  Resource:
                    Fn::GetAtt: [createQuestion, Arn]
                  Parameters:
                    questionPath: "$"
                    projectId: "$.data.projectId"
                    isbn: "$.isbn"
                    packageId: "$.packageId"
                    jobId: "$.jobId"
                  End: true
            ResultPath: "$.resourceCreateResults"
            Next: CheckQuestionCreateStatus

传入该状态的事件结构：

{
   "fileName":"1715254710431.zip",
   "filePath":"contents/source/dede7652-0cd5-4e19-8bf7-76ea853d3acc/1715254710431.zip",
   "isbn":"1715254710431",
   "packageType":"TEST",
   "packageId":"01J02HVK6QAAPGMN1CGK7T0R5C",
   "jobId":"dede7652-0cd5-4e19-8bf7-76ea853d3acc",
   "createdBy":"test@abc.com",
   "data":{
      "stepStatus":"SUCCEEDED",
      "projectId":"69cad2bc-d9ee-4d7d-8711-3dbb5c4bf060",
      "source":"ABC",
      "questions":[
         "questions/un02_as01_q111.xml",
         "questions/un03_as01_q111.xml"
      ]
   }
}

问题：Map迭代时，questionPath能正常获取data.questions中的元素，但projectId、isbn等参数无法从原始事件中取值。

原因分析 #

Map状态默认会将ItemsPath指定的数组中的每个元素单独作为输入传递给Iterator，此时Iterator内部的路径表达式（如$.data.projectId）是基于当前迭代项的上下文，而非原始事件的上下文，所以无法访问到原始事件中的顶层参数或data下的其他字段。

解决方法 #

在Iterator的Task参数中，使用**$$.Execution.Input**来引用原始执行的完整输入事件，通过这个路径可以直接获取原始事件中的任意参数。

修改后的Serverless.yml中Task的Parameters部分如下：

CreateQuestion:
  Type: Task
  Resource:
    Fn::GetAtt: [createQuestion, Arn]
  Parameters:
    questionPath: "$"  # 仍指向当前迭代的question元素
    projectId: "$$.Execution.Input.data.projectId"
    isbn: "$$.Execution.Input.isbn"
    packageId: "$$.Execution.Input.packageId"
    jobId: "$$.Execution.Input.jobId"
  End: true

说明 #

• $$是Step Functions中的上下文变量前缀，用于访问系统上下文数据；
• $$.Execution.Input代表整个执行流程的初始输入事件，通过它可以直接获取原始事件中的所有字段，不受Map迭代上下文的限制；
• 这种方式无需修改Map状态的其他配置，直接在Iterator内部调整参数路径即可实现需求。

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