在无服务器 lambda 中返回 HTTP 错误代码的正确方法是什么

Question

我有一个用 Node.JS 编写的无服务器 lambda 函数。

返回错误代码的最佳/正确方法是什么？

我现在使用的模式（并且有效！）是：

module.exports.endpoint = (event, context, callback) => {
    const response = {
        statusCode: 404,
        body: JSON.stringify({ message: 'Hello World!' })
    };
    callback(null, response);
}

当我拨打电话（例如从 POSTMAN）到我的端点时，我得到：

Status: 404 Not Found 正是我所期待的。

此外，在日志中我可以看到：

Serverless: GET / (λ: get)
Serverless: [404] {"statusCode":404,"body":"{\"message\":\"Hello World!\"}"}

效果很好。

令我困扰的是我将 null 作为错误传递。查看其他一些 tutorials/examples 我发现了如下模式：

https://aws.amazon.com/blogs/compute/error-handling-patterns-in-amazon-api-gateway-and-aws-lambda/

https://serverless.com/framework/docs/providers/aws/events/apigateway/

callback ("the sky is falling!");

callback("[BadRequest] Validation error: Missing field 'name'");

callback("[404] Not Found");

callback(new Error('[404] Not found'));

callback(JSON.stringify(myErrorObj));

所有这些都非常有意义，您可以指定 HTTP 状态代码 - 但我最终得到的是 HTTP 状态代码 200。当我查看日志时，我可以看到错误紧接着是 200:

Serverless: GET / (λ: get)
Serverless: Failure: the sky is falling!
Serverless: Replying 200

Serverless: GET / (λ: get)
Serverless: Failure: [BadRequest] Validation error: Missing field 'name'
Serverless: Replying 200

Serverless: GET / (λ: get)
Serverless: Failure: [404] Not Found
Serverless: Replying 200

Serverless: GET / (λ: get)
Serverless: Failure: [404] Not found
Serverless: Replying 200

Serverless: GET / (λ: get)
Serverless: Failure: {"errorType":"InternalServerError","httpStatus":500,"message":"An unknown error has occurred. Please try again."}
Serverless: Replying 200

在这个地方我找到了以下解释： https://github.com/serverless/serverless/issues/4119

If you want to respond with HTTP errors in that case, you have to encode the HTTP error as successful Lambda response

使用以下示例：

Sample 403:
callback(null, { statusCode: 403, body: "Forbidden", headers: { "Content-Type": "text/plain" } });
Sample 404:
callback(null, { statusCode: 400 });

所以这基本上和我一样。为了完整起见，我可以补充一点，还有很多使用 context.fail(result) 或 context.succeed(result) 的示例 - 但据我收集的信息，context 已被弃用，不应使用（即使它仍然有效）。

使用 callback(error) 有什么意义？

Answer 1

If you want to respond with HTTP errors in that case, you have to encode the HTTP error as successful Lambda response

此类错误处理特定于 API 网关。

就像在传统的 Node Web 服务器（例如 express）中一样，您可以使用 throw new Error('Invalid Payload') 抛出任何错误，中间件通常会将其转换为具有正确响应状态的 HTTP 响应。

在API Gateway Lambda中，可以这样写...

function createResponse(status, body) {
  return {
    headers: {
      'Access-Control-Allow-Origin': '*'
    },
    statusCode: status,
    body: JSON.stringify(body)
  }
}

module.exports.endpoint = (event, context, callback) => {
    try {
      return callback(null, createResponse(200, processEvent(event)))
    } except (e) {
      console.error(e)

      return callback(null, createResponse(500, {
        error: 'Internal Server Error'
      }))
    }
}

基本上，这是一个已处理的错误。 lambda 函数成功但请求失败（可能是 400、404 或 500）。

您应该始终处理错误，否则如果您的处理程序崩溃（由于运行时错误或语法错误或任何未处理的错误），您的用户将收到意外响应（500 或 502），您可能不想。

请记住，Lambda 不仅用于 API 网关。 callback(error) 用于非 API 网关触发的 Lambda。

例如，如果您有一个 SNS 触发的 Lambda，您可以 return callback('Any error message here') 它会让 SNS 知道它失败了，因此 SNS 可以重试调用。

在无服务器 lambda 中返回 HTTP 错误代码的正确方法是什么

What's the correct way of returning HTTP error codes in serverless lambda

node.js

aws-lambda

aws-api-gateway

serverless-framework

serverless