如何强制AWS Step Functions状态机接收对象而非数组输入？

为何输入会变成数组格式？ #

EventBridge Pipes对接SQS源时默认启用批处理模式，哪怕队列中只有一条消息，也会将其包装为数组传入目标输入转换器。你的输入转换器规则会被逐一应用到数组内的每个消息对象，最终输出自然是数组格式的结果。

另外你提到<$.body>在UI测试器中显示正确但执行报错，是因为测试器默认模拟单消息输入（非批处理场景），但实际运行时Pipe以批处理模式传递数组，<$.body>在数组对象上无法找到对应字段，因此报错。

如何避免数组格式输入？ #

方法一：关闭Pipe的批处理模式（推荐） #

在Pipe的SQS源配置中，找到批处理模式选项，设置为「禁用」（Disabled）。此后每条消息会被单独处理，输入转换器将接收单个消息对象，输出即为你期望的单个JSON结构：

{ "domain": "stackoverflow.com" }

这种方式完全匹配你的业务逻辑：

• 状态机所有嵌套步骤无需额外配置InputPath: "$.[0]"，直接使用原始输入即可
• Lambda代码只需处理单个对象，符合逻辑预期
• 手动触发状态机时，传递单个对象即可，和实际运行输入格式一致，避免误操作

方法二：在输入转换器中指定数组第一个元素 #

如果不想修改批处理设置，可调整输入转换器的JSONPath，直接引用数组的第一个元素：

{ "domain": "<$.[0].body.domain>" }

此方法适合你能确保每次批处理仅包含一条消息的场景，输出结果为单个对象。

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