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

错误处理

本节描述运行时系统错误，以及如何处理它们。它还描述特定于 Amazon Rekognition 的错误消息和代码。

错误组成部分

当程序发送一个请求时，Amazon Rekognition 会尝试处理该请求。如果请求成功，Amazon Rekognition 将返回一个 HTTP 成功状态代码 (200 OK)，以及所请求操作的结果。

如果该请求不成功，Amazon Rekognition 会返回一个错误。每个错误包含三个部分：

AWS SDK 负责将错误传播到应用程序，以便您能执行适当操作。例如，在 Java 程序中，您可以编写 try-catch 逻辑以处理 ResourceNotFoundException。

如果您使用的不是 AWS SDK，将需要分析来自 Amazon Rekognition 的低级响应的内容。以下是此类响应的示例：

HTTP/1.1 400 Bad Request
Content-Type: application/x-amz-json-1.1
Date: Sat, 25 May 2019 00:28:25 GMT
x-amzn-RequestId: 03507c9b-7e84-11e9-9ad1-854a4567eb71
Content-Length: 222
Connection: keep-alive

{"__type":"InvalidS3ObjectException","Code":"InvalidS3ObjectException","Logref":"5022229e-7e48-11e9-9ad1-854a4567eb71","Message":"Unable to get object metadata from S3. Check object key, region and/or access permissions."}

错误消息和代码

以下是 Amazon Rekognition 返回的异常列表，按 HTTP 状态代码分组。如果确定重试？为是，则可以在此提交相同请求。如果确定重试？为否，则需要先解决客户端问题，然后再提交新请求。

HTTP 状态代码 400

HTTP 400 状态代码表示与请求相关的问题。有些问题示例是关于身份验证失败、缺少必需参数或超出操作的预配置吞吐量。必须先解决应用程序中存在的问题，然后再重新提交请求。

HTTP 状态代码 5xx

HTTP 5xx 状态代码表示必须由 AWS 解决的问题。This might be a transient error。如果是临时错误，您可以重试请求，直到操作成功。否则，请转至 AWS 服务运行状况控制面板以查看是否存在与服务相关的任何操作问题。

应用程序中的错误处理

为了让应用程序平稳运行，您需要添加逻辑以捕获错误并做出响应。典型的方法包括使用 try-catch 块或 if-then 语句。

AWS SDK 可自行重试和检查错误。如果您在使用某个 AWS 开发工具包时遇到错误，错误代码和错误描述可帮助您纠正错误。

您还应该会在响应中看到 Request ID。如果您需要使用 AWS Support 来诊断问题，则 Request ID 会很有用。

以下 Java 代码段尝试检测图像中的对象并执行基本错误处理。（在这种情况下，它会向用户告知请求失败。）

try {
    DetectLabelsResult result = rekognitionClient.detectLabels(request);
    List <Label> labels = result.getLabels();

    System.out.println("Detected labels for " + photo);
    for (Label label: labels) {
        System.out.println(label.getName() + ": " + label.getConfidence().toString());
    }
} 
catch(AmazonRekognitionException e) {
    System.err.println("Could not complete operation");
    System.err.println("Error Message:  " + e.getMessage());
    System.err.println("HTTP Status:    " + e.getStatusCode());
    System.err.println("AWS Error Code: " + e.getErrorCode());
    System.err.println("Error Type:     " + e.getErrorType());
    System.err.println("Request ID:     " + e.getRequestId());
}
catch (AmazonClientException ace) {
    System.err.println("Internal error occurred communicating with Rekognition");
    System.out.println("Error Message:  " + ace.getMessage());
}

在此代码段中，try-catch 结构处理两种不同的异常：