Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Step Functions 中的错误处理

任何状态都可能会遇到运行时错误。错误可能由于各种原因发生：

默认情况下，当某个状态报告错误时，Amazon Step Functions 会导致执行完全失败。

错误名称

Step Functions 使用称为区分大小写的字符串在亚马逊状态语言中标识错误错误名称. 亚马逊状态语言定义一组内置字符串用于命名广为人知的错误，均以States.prefix.

状态可以报告具有其他名称的错误。但是，这些名称不得 States. 前缀开头。

作为最佳实践，确保生产代码可以处理 Amazon Lambda 服务异常（Lambda.ServiceException 和 Lambda.SdkClientException）。有关更多信息，请参阅处理 Lambda 服务异常。

出错后重试

Task 和 Parallel 状态可以有名为 Retry 的字段，其值必须是称为重试器 的对象的数组。一个重试器表示特定重试次数，通常重试之间的时间间隔会增加。

重试器包含以下字段。

此 Retry 示例在等待 3 秒和 4.5 秒之后，尝试 2 次重试。

"Retry": [ {
   "ErrorEquals": [ "States.Timeout" ],
   "IntervalSeconds": 3,
   "MaxAttempts": 2,
   "BackoffRate": 1.5
} ]

重试器的 ErrorEquals 字段中显示的保留名称 States.ALL 是一个通配符，与所有错误名称匹配。它必须单独显示在 ErrorEquals 数组中，并且必须显示在 Retry 数组的最后一个重试器中。名称States.TaskFailed还可以作为通配符并匹配任何错误，除了States.Timeout.

Retry 字段的此示例重试 States.Timeout 之外的任意错误。

"Retry": [ {
   "ErrorEquals": [ "States.Timeout" ],
   "MaxAttempts": 0
}, {
   "ErrorEquals": [ "States.ALL" ]
} ]

复杂的重试场景

在单状态执行的上下文中，重试器的参数应用到对该重试器的所有访问。

考虑以下 Task 状态。

"X": {
   "Type": "Task",
   "Resource": "arn:aws:states:us-east-1:123456789012:task:X",
   "Next": "Y",
   "Retry": [ {
      "ErrorEquals": [ "ErrorA", "ErrorB" ],
      "IntervalSeconds": 1,
      "BackoffRate": 2.0,
      "MaxAttempts": 2
   }, {
      "ErrorEquals": [ "ErrorC" ],
      "IntervalSeconds": 5
   } ],
   "Catch": [ {
      "ErrorEquals": [ "States.ALL" ],
      "Next": "Z"
   } ]
}

此任务连续失败五次，输出以下错误名称：ErrorA、ErrorB、ErrorC、ErrorB 和 ErrorB。出现以下结果：

回退状态

Task、Map和Parallel状态可以具有名为的字段Catch. 此字段的值必须是称为捕获器 的对象的数组。

捕获器包含以下字段。

当某个状态报告错误并且没有时，Retry字段中，如果重试无法解决错误，Step Functions 将按照数组中列出的顺序全面地扫描捕获器。当错误名称显示在捕获器的 ErrorEquals 字段中时，状态机转换为在 Next 字段中指定的状态。

捕获器的 ErrorEquals 字段中显示的保留名称 States.ALL 是一个通配符，与所有错误名称匹配。它必须单独显示在 ErrorEquals 数组中，并且必须显示在 Catch 数组的最后一个捕获器中。名称States.TaskFailed还可以作为通配符并匹配任何错误，除了States.Timeout.

以下示例为Catch字段转换为名为的状态RecoveryState当 Lambda 函数输出未处理的 Java 异常时。否则，该字段转换为 EndState 状态。

"Catch": [ {
   "ErrorEquals": [ "java.lang.Exception" ],
   "ResultPath": "$.error-info",
   "Next": "RecoveryState"
}, {
   "ErrorEquals": [ "States.ALL" ],
   "Next": "EndState"
} ]

错误输出

当 Step Functions 转换为捕获名称中指定的状态时，对象通常包含字段。Cause. 此字段的值是人类可读格式的错误说明。该对象称为错误输出。

在本示例中，第一个捕获器包含一个 ResultPath 字段。其工作方式类似于状态顶级中的 ResultPath 字段，有两种可能的结果：

因此，在本示例中，对于第一个捕获器，错误输出作为名为 error-info 的字段添加到输入 (如果输入中尚未存在具有此名称的字段)。然后，整个输入发送到 RecoveryState。对于第二个捕获器，错误输出会覆盖输入，仅将错误输出发送到 EndState。

当一个州有两者时Retry和Catch字段中，Step Functions 首先使用任意合适的重试器，只有在重试策略无法解决错误之后才应用匹配的捕获器转换。

导致有效负载和服务集成

捕手返回字符串有效负载作为输出。使用诸如 Amazon Athena 等服务集成时，或Amazon CodeBuild，您可能需要转换Cause字符串转换为 JSON。以下带有内部函数的 Pass 状态示例说明了如何将原因字符串转换为 JSON。

"Handle escaped JSON with JSONtoString": {
  "Type": "Pass",
  "Parameters": {
    "Cause.$": "States.StringToJson($.Cause)"
  },
  "Next": "Pass State with Pass Processing"
},

使用重试和使用 Catch 的示例

以下示例中定义的状态机假定存在两个 Lambda 函数：一个始终失败，另一个等待足够长的时间，以允许发生状态机中定义的超时。

这是始终失败的 Lambda 函数的定义，返回消息。error. 在后面的状态机示例中，此 Lambda 函数名为FailFunction.

exports.handler = (event, context, callback) => {
    callback("error");
};

这是一个休眠 10 秒的 Lambda 函数的定义。在后面的状态机示例中，此 Lambda 函数名为sleep10.

exports.handler = (event, context, callback) => {
    setTimeout(function(){
    }, 11000);
};

使用 “重试” 处理失败

此状态机使用 Retry 字段重试失败的函数，并输出错误名称 HandledError。该函数重试两次，在两次重试之间使用指数回退。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Retry": [ {
            "ErrorEquals": ["HandledError"],
            "IntervalSeconds": 1,
            "MaxAttempts": 2,
            "BackoffRate": 2.0
         } ],
      "End": true
      }
   }
}

此变体使用预定义的错误代码States.TaskFailed，这与 Lambda 函数输出的任意错误匹配。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Retry": [ {
            "ErrorEquals": ["States.TaskFailed"],
            "IntervalSeconds": 1,
            "MaxAttempts": 2,
            "BackoffRate": 2.0
         } ],
         "End": true
      }
   }
}

使用 Catch 处理失败

此示例使用 Catch 字段。当 Lambda 函数输出错误时，会捕获错误，并且状态机转换为fallback状态。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Catch": [ {
            "ErrorEquals": ["HandledError"],
            "Next": "fallback"
         } ],
         "End": true
      },
      "fallback": {
         "Type": "Pass",
         "Result": "Hello, Amazon Step Functions!",
         "End": true
      }
   }
}

此变体使用预定义的错误代码States.TaskFailed，这与 Lambda 函数输出的任意错误匹配。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Catch": [ {
            "ErrorEquals": ["States.TaskFailed"],
            "Next": "fallback"
         } ],
      "End": true
      },
      "fallback": {
         "Type": "Pass",
         "Result": "Hello, Amazon Step Functions!",
         "End": true
      }
   }
}

使用 “重试” 处理超时

此状态机使用 Retry 字段重试已超时的函数。该函数重试两次，在两次重试之间使用指数回退。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:sleep10",
         "TimeoutSeconds": 2,
         "Retry": [ {
            "ErrorEquals": ["States.Timeout"],
            "IntervalSeconds": 1,
            "MaxAttempts": 2,
            "BackoffRate": 2.0
         } ],
         "End": true
      }
   }
}

使用 Catch 处理超时

此示例使用 Catch 字段。在出现超时的情况下，状态机会转换为 fallback 状态。

{
   "Comment": "A Hello World example of the Amazon States Language using an Amazon Lambda function",
   "StartAt": "HelloWorld",
   "States": {
      "HelloWorld": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:sleep10",
         "TimeoutSeconds": 2,
         "Catch": [ {
            "ErrorEquals": ["States.Timeout"],
            "Next": "fallback"
         } ],
         "End": true
      },
      "fallback": {
         "Type": "Pass",
         "Result": "Hello, Amazon Step Functions!",
         "End": true
      }
   }
}