API Gateway同步调用AWS Step Function Express工作流如何仅返回output节点

你现在碰到的带billingDetails、executionArn这类冗余字段的响应，和你在状态机里配的ResultPath、OutputPath完全不冲突，也不是你配置错了：

• 这些外层字段是Step Functions 同步触发Express工作流的StartSyncExecution接口自带的响应元数据，是AWS在API层面自动附加的内容，根本不经过状态机的执行逻辑，不管你怎么改状态机的路径配置，都动不了这些字段。
• 你现在配的OutputPath: $.Payload其实已经生效了——看返回示例里的output字段，装的就是Lambda返回的业务内容，这部分完全符合预期，只是AWS把这部分业务内容塞到了响应的output子节点里，外面套了一层和业务无关的执行元数据。
• 之前用REST API的时候能拿到很干净的业务响应，是因为REST API自带Velocity映射模板，可以直接把$.output字段抠出来当最终响应；但HTTP API早期确实没有这类模板转换能力，很多刚切到HTTP API做同步编排的人，都会碰到把整个执行元数据抛给调用方的问题。

先把你提的两个约束明确下来：

• 不插Lambda、不额外加任何服务在API Gateway和Step Functions的链路中间
• 不改动原有API的路由结构，不偏离用Step Functions做编排的初衷
  整个方案分两部分：一部分是把状态机本身的配置调顺，避免多层序列化；另一部分是用HTTP API自带的轻量能力把外层冗余字段过滤掉——毕竟这些外层字段是API层加的，单靠改状态机是肯定删不掉的，不然就成无厘头的魔法了。

第一步：调整状态机配置 #

把你现在的状态机定义稍微优化下，删掉冗余配置，避免输出被多层序列化：

{
  "Comment": "Simple Lambda Function",
  "StartAt": "Invoke Lambda function",
  "States": {
    "Invoke Lambda function": {
      "Type": "Task",
      "Resource": "arn:aws:states:::lambda:invoke",
      "OutputPath": "$.Payload",
      "Parameters": {
        "FunctionName": "LAMBDA ARN",
        "Payload": {
          "input.$": "$"
        }
      },
      "End": true
    }
  }
}

• 删掉原来的ResultPath: $配置：这个配置本来的作用是把Task的结果覆盖整个状态机输入，在同步Express工作流里属于冗余项，还容易导致Lambda返回的Payload被多套一层序列化，最后拿到的output是一串转义的字符串，而不是可直接解析的原生JSON对象。
• 保留OutputPath: $.Payload：确保状态机最终输出的就是Lambda返回的业务内容，不会夹带Step Functions调用Lambda时的额外元数据（比如Lambda调用ID、调用状态码这类）。

第二步：用HTTP API原生能力过滤外层冗余字段 #

这里要纠正一个很常见的认知偏差：HTTP API不是完全没有响应处理能力，它上线的*参数映射（Parameter Mapping）*是网关自带的内置功能，根本不需要写模板、不需要加服务，操作和配状态机的逻辑一样简单：

1. 打开对应HTTP API的路由配置，找到关联Step Functions的AWS服务集成项
2. 找到「响应参数」配置区，加一条映射规则：把最终返回给调用方的响应体值，直接指向Step Functions完整响应里的$.output字段。配置完成后，API Gateway会自动从Step Functions返回的完整结构里，把output字段的业务内容抠出来当最终响应，所有外层的billingDetails、executionArn、startDate这类非必要字段会被直接丢弃，不会传给调用方。
3. 顺手加个HTTP状态码映射：把Step Functions返回的$.status字段和标准HTTP状态码对齐（比如状态为SUCCEEDED就返回200，FAILED就返回500），让接口的返回逻辑完全符合正常HTTP接口的规范。

这里要特意说明：这个配置完全不算加额外服务层——因为你用的就是API Gateway本身的内置能力，只是让网关把本来就属于业务输出的内容透传出去，没有在原有的API Gateway -> Step Functions链路上插入任何新的计算服务，完全符合你提的要求。

很多人刚踩这个坑的时候都会琢磨：我能不能通过调整状态机的OutputPath，让API Gateway直接返回干净的响应？本质上是搞混了两个层的边界：

• 状态机内部的ResultPath、OutputPath，控制的是状态机执行完成后，响应里output这个子节点装的是什么业务内容
• 而你想删掉的那些外层字段，是属于API接口的响应信封，这个信封是AWS在收到你的StartSyncExecution调用时自动加上的，和状态机内部跑了什么逻辑完全没关系。哪怕你把状态机的OutputPath设为空，外层的那些billingDetails、executionArn字段还是会存在。想要把这些字段去掉，必须在拿到完整响应的第一层（也就是API Gateway）做提取，单靠改状态机定义是绕不开的。

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