为何API Gateway测试异步Lambda不等待执行、如何返回非202状态

核心原因 #

你始终收到202无响应的结果，完全不是Lambda代码的问题。你之前在API Gateway集成请求中手动添加的X-Amz-Invocation-Type: 'Event'配置，本身就把API Gateway对Lambda的调用模式强制改成了异步触发。
这个模式的原生逻辑是：API Gateway只负责把调用请求推送给Lambda服务，只要Lambda服务端确认接收成功，就立刻向调用方返回202 Accepted的空响应，全程不会等待Lambda函数的实际执行结果。这就是你写不同的Lambda测试代码，响应结果完全没有变化的根本原因。

具体操作步骤 #

• 打开API Gateway对应资源的「集成请求」配置页，找到你之前手动添加的X-Amz-Invocation-Type头映射规则，直接整条删除。

  不要修改这个头的取值来“切换同步模式”，直接删除整条规则最稳妥。没有手动指定这个头时，API Gateway对Lambda的默认调用模式是RequestResponse，也就是完全同步等待Lambda执行完成，再将返回结果映射为HTTP响应返回给调用方。

• 删除头规则后，重新将API部署到你正在测试的Stage。改完配置不重新部署的话，测试用的还是旧的异步触发配置，改动不会生效。
• 修正Lambda的返回格式，适配API Gateway的响应解析规则。你当前的Lambda返回内容API Gateway无法正确解析，正确的同步返回结构示例：

  // SDK按需引入即可，基础响应无需额外依赖
  exports.handler = async function (event, context) {
    return {
      isBase64Encoded: false,
      statusCode: 200,
      headers: {
        "Access-Control-Allow-Origin": "*",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        message: "Success"
      })
    }
  };
  

  之前你代码里自定义的httpStatus字段API Gateway识别不到，即便同步调用打通，也无法生成正确的HTTP状态码。

模式选择参考 #

• 如果你需要拿到Lambda的执行结果作为API响应，按上面的步骤改成同步模式即可
• 如果你本身就需要“接收到请求立刻返回，后台异步处理任务”的效果，保留当前的异步配置就好——这种场景下202就是符合预期的正确响应，不需要等待Lambda的执行结果。

内容的提问来源于stack exchange，提问作者Philip H