AWS API Gateway集成Step Functions：非压缩XML负载无法触发状态机问询

结合AWS API Gateway与Step Functions集成的机制，针对你遇到的现象（仅压缩XML+模板1/2成功，未压缩XML+所有模板失败，模板3未达预期），可能的原因如下：

1. 未压缩请求的编码标识或API Gateway解压逻辑异常 #

• 发送压缩XML（payload1）时，客户端通常会携带Content-Encoding: gzip/deflate请求头，API Gateway会自动解压后将原始XML传递给映射模板。
• 若未压缩XML（payload2）的请求误携带了Content-Encoding头（客户端配置错误），API Gateway会尝试对未压缩内容执行解压操作，直接破坏XML结构；反之，若API Gateway阶段配置强制要求请求压缩，未携带该头的payload2会被直接拦截。

2. 映射模板3的XML解析逻辑仅适配压缩请求的特定结构 #

Step Functions集成要求映射模板输出符合StartExecution API规范的JSON（核心是input字段需包含有效内容）。若模板3存在以下问题，会导致未压缩XML处理失败：

• XPath表达式不匹配：模板3使用的XPath（如$input.xmlToJson('//RootNode')）仅能匹配payload1的XML根节点结构，而payload2的XML根节点名称或层级不同，解析后得到空值，导致Step Functions收到无效请求。
• XML转JSON语法错误：模板3可能依赖压缩XML解压后的特定格式（如自动添加的缩进、换行），而未压缩XML的原始格式（如无缩进）触发了XML解析器的语法错误，导致映射模板执行失败。

3. 未压缩XML的payload大小超出API Gateway限制 #

API Gateway默认的同步请求payload大小限制为10MB，若未压缩的payload2超过该阈值，API Gateway会直接截断请求，不会将其转发至Step Functions；而压缩后的payload1因体积缩小在限制范围内，因此能正常执行。

4. 映射模板3未处理XML中的特殊字符 #

若payload2的XML包含未转义的特殊字符（如&、<、>），而模板3未使用$util.escapeJavaScript()或$util.escapeXml()对XML内容进行转义，生成的JSON会存在语法错误，Step Functions无法解析该请求，导致负载无法送达。压缩后的payload1可能在压缩前已完成特殊字符转义，因此模板3能正常处理。

5. API Gateway集成请求的Content Handling配置错误 #

若集成请求的Content Handling设置为Convert to binary，API Gateway会将未压缩的XML视为二进制数据处理，映射模板无法读取文本格式的XML内容，导致转换失败；而压缩XML因被自动解压为文本，不受该配置影响。

排查步骤 #

1. 检查请求头：确认payload2的请求头包含Content-Type: application/xml，且未错误携带Content-Encoding头。
2. 查看CloudWatch日志：在API Gateway的阶段配置中开启日志记录，查看未压缩请求时映射模板的输出内容，确认生成的JSON是否符合Step Functions的StartExecution规范。
3. 验证payload大小：对比payload2的原始大小与API Gateway阶段配置中的Payload Size限制（可在控制台的阶段设置中调整）。
4. 测试模板逻辑：使用payload2的XML内容，在API Gateway的测试控制台中验证模板3的输出，检查XPath表达式或XML转JSON逻辑是否正常工作。
5. 检查Content Handling配置：确认集成请求的Content Handling设置为Passthrough或Convert to text，而非Convert to binary。

内容的提问来源于stack exchange，提问作者concept.io