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

PowerShell 中的 Amazon Lambda 函数错误

您的代码引发错误时，Lambda 将会生成错误的 JSON 表示形式。此错误文档会出现在调用日志和输出中，用于同步调用。

本页介绍如何使用 Lambda 控制台和 Amazon CLI 查看 PowerShell 运行时的 Lambda 函数调用错误。

语法

请考虑以下 PowerShell 脚本示例语句：

throw 'The Account is not found'

在调用此 Lambda 函数时，它将引发终止错误，并且 Amazon Lambda 返回以下错误消息：

{
  "errorMessage": "The Account is not found",
  "errorType": "RuntimeException"
}

注意 errorType 是 RuntimeException，这是 PowerShell 引发的默认异常。您可以通过引发错误来使用自定义错误类型，如下所示：

throw @{'Exception'='AccountNotFound';'Message'='The Account is not found'}

通过将 errorType 设置为 AccountNotFound，错误消息将进行序列化：

{
  "errorMessage": "The Account is not found",
  "errorType": "AccountNotFound"
}

如果您不需要错误消息，您可以以错误代码的格式引发字符串。错误代码格式要求字符串以字符开头，且后面只能包含字母和数字，不含空格或符号。

例如，如果您的 Lambda 函数包含以下内容：

throw 'AccountNotFound'

错误将进行序列化，如下所示：

{
  "errorMessage": "AccountNotFound",
  "errorType": "AccountNotFound"
}

工作原理

调用 Lambda 函数时，Lambda 将接收调用请求并验证执行角色中的权限、验证事件文档是否是有效的 JSON 文档，并检查参数值。

如果请求通过验证，Lambda 会将请求发送到函数实例。Lambda 运行时环境会将事件文档转换为一个对象，并将该对象传递给函数处理程序。

如果 Lambda 遇到错误，则会返回指示错误原因的异常类型、消息和 HTTP 状态代码。调用 Lambda 函数的客户端或服务可以通过编程方式处理错误或将其一直传递到终端用户。正确的错误处理行为取决于应用程序的类型、受众以及错误来源。

有关调用错误的完整列表，请参阅 InvokeFunction 错误。

使用 Lambda 控制台

您可以通过配置测试事件并查看输出，在 Lambda 控制台上调用函数。输出也会捕获到函数的执行日志中，当启用 active tracing (活动跟踪) 时，会捕获到 Amazon X-Ray 中。

Lambda 控制台会同步调用您的函数并显示结果。要查看响应、日志和其他信息，请展开 Details (详细信息) 部分。

使用 Amazon Command Line Interface (Amazon CLI)

Amazon CLI 是一种开源工具，让您能够在命令行 Shell 中使用命令与 Amazon 服务进行交互。要完成本节中的步骤，您必须满足以下条件：

在 Amazon CLI 中调用 Lambda 函数时，Amazon CLI 会将响应分为两个文档。Amazon CLI 响应将显示在命令提示符中。如果发生错误，响应将包含一个 FunctionError 字段。函数返回的调用响应或错误将写入到输出文件。例如，output.json 或 output.txt。

以下调用 命令示例演示了如何调用函数并将调用响应写入 output.txt 文件。

aws lambda invoke   \
  --function-name my-function   \
      --cli-binary-format raw-in-base64-out  \
          --payload '{"key1": "value1", "key2": "value2", "key3": "value3"}' output.txt

如果使用 cli-binary-format 版本 2，则 Amazon CLI 选项是必需的。要将其设为默认设置，请运行 aws configure set cli-binary-format raw-in-base64-out。有关更多信息，请参阅 Amazon CLI 支持的全局命令行选项。

命令提示符中应该会显示 Amazon CLI 响应：

{
    "StatusCode": 200,
    "FunctionError": "Unhandled",
    "ExecutedVersion": "$LATEST"
}

output.txt 文件中应该会显示函数调用响应：在同一命令提示符下，您还可以使用以下命令在命令提示符中查看输出：

cat output.txt

命令提示符中应该会显示调用响应。

Lambda 还会在函数日志中记录错误对象，最多 256 KB。有关更多信息，请参阅PowerShell 中的 Amazon Lambda 函数日志记录。

其他 Amazon 服务中的错误处理

当其他 Amazon 服务调用您的函数时，服务会选择调用类型和重试行为。Amazon 服务可以按计划调用您的函数，以响应资源上的生命周期事件或者针对来自用户的请求提供响应。某些服务异步调用函数并让 Lambda 处理错误，而其他服务则重试或将错误传回给用户。

例如，API Gateway 将所有调用和函数错误视为内部错误。如果 Lambda API 拒绝调用请求，则 API Gateway 会返回 500 错误代码。如果函数运行但返回错误，或返回格式错误的响应，则 API Gateway 返回 502 错误代码。要自定义错误响应，您必须捕获代码中的错误并以所需格式设置响应的格式。

建议使用 Amazon X-Ray 来确定错误来源及其原因。您可使用 X-Ray 找出哪个组件遇到了错误，并查看有关错误的详细信息。以下示例显示导致 API Gateway 发出 502 响应的函数错误。

有关更多信息，请参阅配合使用 Amazon Lambda 和 Amazon X-Ray。

接下来做什么？