本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

處理 Step Functions 工作流程中的錯

除了Pass和狀態之外的所有Wait狀態都可能會遇到執行階段錯誤。錯誤可能由於各種原因而發生，例如：

默認情況下，當狀態報告錯誤時， AWS Step Functions 導致執行完全失敗。

錯誤名稱

Step Functions 使用區分大小寫的字串 (稱為錯誤名稱) 識別 Amazon 州語言中的錯誤。Amazon States 語言會定義一組內建字串，這些字串命名為已知錯誤，全部都以前置States.詞開頭。

狀態可以回報具有其他名稱的錯誤。但是，這些錯誤名稱不能以States.前綴開頭。

作為最佳實踐，確保生產代碼可以處理 AWS Lambda 服務例外（Lambda.ServiceException和Lambda.SdkClientException）。如需詳細資訊，請參閱處理暫態 Lambda 服務例外。

發生錯誤後重試

Task、Parallel、和Map狀態可以有一個名為的欄位Retry，其值必須是稱為擷取器的物件陣列。個別的 Retrier 代表特定的重試次數，通常為較長的時間間隔。

當其中一個狀態報告錯誤且有Retry欄位時，Step Functions 會依陣列中列出的順序掃描擷取器。當錯誤名稱出現在檢索器欄位的值中時，狀態機會按照ErrorEquals欄位中的定義進行重試嘗試。Retry

如果您的 redriven 執行會重新執行工作流程狀態平行工作流狀態、或 Inline Map 狀態 (您已針對其定義重試)，這些狀態的重試嘗試次數會重設為 0，以允許嘗試次數上限 redrive。 對於一個 redriven 執行時，您可以使用控制台跟踪這些狀態的個別重試嘗試。如需詳細資訊，請參閱 使用 重新啟動狀態機器執行 redrive 在步驟函數中 中的 的重試行為 redriven 執行。

Retrier 包含下列欄位：

重試欄位範例

本節包含下列Retry欄位範例。

範例 1 — 重試 BackoffRate

下列的範例Retry會在等待三秒鐘後進行兩次重試，而第一次重試會進行。根據BackoffRate您指定的，「Step Functions 數」會增加每次重試之間的間隔，直到達到重試嘗試次數上限為止。在下列範例中，第二次重試嘗試會在第一次重試後等待三秒鐘後開始。

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

範例 2 — 重試 MaxDelaySeconds

下列範例會進行三次重試，並限制 5 秒後產生的BackoffRate等待時間。第一次重試會在等待三秒鐘後進行。第二次和第三次重試嘗試會在前一次重試嘗試後等待五秒鐘後發生，因為等待時間上限是由設定的最大等待時間限制MaxDelaySeconds。

"Retry": [ {
    "ErrorEquals": [ "States.Timeout" ],
    "IntervalSeconds": 3,
    "MaxAttempts": 3,
    "BackoffRate":2,
    "MaxDelaySeconds": 5,
    "JitterStrategy": "FULL"
} ]

如果沒有MaxDelaySeconds，則第二次重試會在第一次重試六秒後進行，第三次重試會在第二次重試後 12 秒進行。

範例 3 — 重試除狀態之外的所有錯誤。逾時

出現在 Retrier 的 ErrorEquals 欄位中的預留名稱 States.ALL 是符合任何錯誤名稱的萬用字元。它必須單獨顯示在 ErrorEquals 陣列中，而且必須顯示在 Retry 陣列的最後一個 Retrier 中。該名稱States.TaskFailed還具有通配符，並匹配除外的任何錯誤States.Timeout。

下列Retry欄位範例會重試除外States.Timeout的任何錯誤。

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

範例 4 — 複雜的重試案例

Retrier 的參數會套用於在單一狀態執行的範疇中對 Retrier 的所有造訪。

請考慮以下 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"
   } ]
}

此工作連續失敗四次，輸出以下錯誤名稱：ErrorAErrorB、ErrorC、和ErrorB。因此會發生下列情況：

后援国家

TaskMap和Parallel狀態每個狀態都可以有一個名為的欄位Catch。此欄位的值必須物件陣列，也稱為 Catcher。

Catcher 包含下列欄位。

當狀態報告錯誤且沒有Retry欄位，或者如果重試無法解決錯誤，Step Functions 會依陣列中列出的順序掃描擷取器。當錯誤名稱顯示於 Catcher 的 ErrorEquals 欄位值時，狀態機器會轉換到 Next 欄位中具名的狀態。

出現在 Catcher 的 ErrorEquals 欄位中的預留名稱 States.ALL 是符合任何錯誤名稱的萬用字元。它必須單獨顯示在 ErrorEquals 陣列中，而且必須顯示在 Catch 陣列的最後一個 Catcher 中。該名稱States.TaskFailed還具有通配符，並匹配除外的任何錯誤States.Timeout。

下列Catch欄位範例會轉換至 Lambda 函數輸出未處理的 Java 例外狀況RecoveryState時命名的狀態。否則，此欄位會轉換到 EndState 狀態。

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

錯誤輸出

當 Step Functions 轉換到 catch 名稱中指定的狀態時，該對象通常包含該字段Cause。此欄位的值是人類可讀的錯誤描述。此物件也稱為「錯誤輸出」。

在這個範例中，第一個 Catcher 包含 ResultPath 欄位。其運作方式類似於狀態最上層中的 ResultPath 欄位，會造成兩種可能性：

因此，對於示例中的第一個捕獲器，捕手將錯誤輸出添加到輸入中，error-info如果輸入中還沒有具有此名稱的字段，則命名為的字段。然後，捕手將整個輸入發送到RecoveryState。對於第二個捕獲器，錯誤輸出會覆蓋輸入，捕手僅將錯誤輸出發送到EndState。

當一個狀態同時具有Retry和Catch字段時，Step Functions 首先使用任何適當的檢索器。如果重試原則無法解決錯誤，「Step Functions」會套用相符的捕捉器轉換。

原因有效載荷和服務整合

捕手返回一個字符串有效載荷作為輸出。使用 Amazon Athena 之類的服務集成或 AWS CodeBuild，您可能希望將Cause字符串轉換為JSON。以下具有內在函數的Pass狀態示例演示了如何將Cause字符串轉換為。JSON

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

使用「重試」和使用 Catch 的狀態機示例

以下範例中定義的狀態機器假設存在兩個 Lambda 函數：一個永遠失敗，另一個等待足夠長的時間以允許狀態機器中定義的逾時發生。

這是一個 Node.js Lambda 函數的定義，它總是失敗，返回消息error。在接下來的狀態機範例中，會命名此 Lambda 函數FailFunction。如需建立 Lambda 函數的相關資訊，請參閱一步驟 1：建立 Lambda 函數節。

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

這是一個 Node.js Lambda 函數的定義，睡眠 10 秒。在接下來的狀態機範例中，會命名此 Lambda 函數sleep10。

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

使用「重試」處理失敗

此狀態機器會使用 Retry 欄位來重試失敗且輸出錯誤名稱 HandledError 的函數。它重試此函數兩次，並在重試之間進行指數輪詢。

{
   "Comment": "A Hello World example of the Amazon States Language using an AWS 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 AWS 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 AWS 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, AWS Step Functions!",
         "End": true
      }
   }
}

此變體使用預先定義的錯誤代碼States.TaskFailed，該代碼與 Lambda 函數輸出的任何錯誤匹配。

{
   "Comment": "A Hello World example of the Amazon States Language using an AWS 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, AWS Step Functions!",
         "End": true
      }
   }
}

使用「重試」處理逾時

此狀態機器會根據中指定的逾時值，使用Retry欄位重試逾時的Task狀態TimeoutSeconds。Step Functions 數會在此Task狀態下重試 Lambda 函數叫用兩次，並在重試之間進行指數輪詢。

{
   "Comment": "A Hello World example of the Amazon States Language using an AWS 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 AWS 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, AWS Step Functions!",
         "End": true
      }
   }
}