API Gateway与Lambda异步调用：如何让网关提前向客户端返回结果

你配置了API Gateway异步调用Lambda（通过X-Amz-Invocation-Type: Event），期望网关立即返回接收成功，但Lambda代码报错时网关仍会等待执行完成并返回错误。核心原因是：异步调用的“即时返回”仅在Lambda成功触发后生效，如果Lambda在初始化阶段或入口函数的同步执行步骤中抛出错误（比如你遇到的TypeError），API Gateway会收到同步错误响应，进而返回给客户端。

1. 修复Lambda代码的触发阶段错误 #

你的错误the JSON object must be str, bytes or bytearray, not dict，是因为Lambda代码里尝试用json.loads()解析已经是字典类型的event['body']。API Gateway如果开启了集成请求的JSON解析（比如使用application/json的映射模板），会自动将请求体解析为dict传入Lambda。

修改Lambda的main.py代码，适配这种情况：

import json

def lambda_handler(event, context):
    # 处理body的两种可能：已解析的dict或原始字符串
    body = event.get('body')
    if isinstance(body, str):
        try:
            body = json.loads(body)
        except json.JSONDecodeError:
            # 可选：记录日志，不影响异步触发
            pass
    # 后续异步处理逻辑（这里即使出错，也不会返回给API Gateway）
    process_request(body)
    # 异步调用下，返回任意内容都不会影响API Gateway的响应（只要触发成功）
    return {"status": "success"}

2. 确保API Gateway的异步调用配置正确 #

• 在API Gateway的集成请求中，确认X-Amz-Invocation-Type头已设置为Event：
  • 进入API Gateway控制台，找到对应资源的集成请求，添加自定义头X-Amz-Invocation-Type，值为Event。
  • 或者在集成请求的“Lambda Function”配置中，直接选择“Invocation Type”为Event（部分控制台版本支持可视化选择）。

3. 配置API Gateway返回固定成功响应 #

为了确保客户端始终收到“请求已接收”的反馈，在API Gateway的集成响应中设置默认响应：

• 选择集成响应的200状态码，添加响应模板（application/json类型），内容为：

  {"status": "received", "message": "请求已接收，正在处理"}
  

• 这样只要Lambda成功触发，API Gateway会立即返回这个固定响应，后续Lambda的执行错误只会记录在CloudWatch日志中，不会传递给客户端。

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