AWS Step Functions中States.Runtime错误处理异常排查求助

可能的原因及修复步骤 #

1. 错误码匹配范围不足 #

你当前的Catch块仅捕获States.Runtime类型的错误，但实际终止执行的异常可能属于其他错误类型：

• 如果是EC2 API调用失败（比如实例ID无效、权限不足），错误码会是EC2服务相关的（例如EC2.InvalidInstanceID.NotFound、EC2.AccessDenied），这类错误不属于States.Runtime，自然不会触发跳转。
• 如果是ResultSelector路径解析失败（比如实例无标签、Reservations/Instances为空），虽然属于States.Runtime的子错误（如States.PathMatchingFailure），但某些场景下显式捕获子错误码能更可靠触发处理。

修复方案：
扩展Catch块的错误码列表，添加更宽泛的匹配或具体的服务错误码：

"Catch": [
  {
    "ErrorEquals": [
      "States.Runtime",
      "EC2.ClientError", // 捕获所有EC2客户端错误
      "States.ALL" // 兜底捕获所有错误，测试阶段可用，上线后建议替换为具体错误码
    ],
    "Next": "RuntimeErrorFallback"
  }
]

2. 确认实际异常的错误码 #

要精准处理，先查看Step Functions执行详情中的错误详情：

• 进入Step Functions控制台，找到对应的执行记录，查看Error字段下的Type值，这就是实际抛出的错误码。
• 将该错误码添加到ErrorEquals数组中，确保Catch块能匹配到。

3. 优化ResultSelector的容错性 #

你的ResultSelector使用了硬编码路径$.Reservations[0].Instances[0].Tags[0].Value，一旦实例无标签、或查询结果为空（比如实例不存在），就会触发Runtime错误。可以通过Step Functions的内置函数优化路径解析，避免抛出异常：

"ResultSelector": {
  "Value.$": "States.GetItem(States.GetItem(States.GetItem($.Reservations, 0).Instances, 0).Tags, 0).Value || 'false'"
}

或者针对特定标签键做灵活匹配：

"ResultSelector": {
  "Value.$": "$.Reservations[0].Instances[0].Tags[?(@.Key=='你的标签键')].Value[0] || 'false'"
}

这样即使标签不存在，也会返回默认值false，流程可以继续走到isInstanceTagged分支，无需触发异常处理。

4. 验证Catch块配置正确性 #

确认DescribeInstances中的Catch块没有拼写错误：

• 检查ErrorEquals中的错误码大小写是否正确（比如States.Runtime是大小写敏感的）。
• 确认Next指向的RuntimeErrorFallback状态确实存在于States定义中。

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