如何通过API Gateway异步调用AWS Lambda适配GitHub Webhook？（Serverless框架）

当然可以实现你想要的需求！通过Serverless框架配置API Gateway和Lambda的集成，完全能做到立即返回HTTP响应给GitHub Webhook，同时让Lambda在后台异步执行，也就是用Lambda的Event调用类型。下面是具体的实现步骤：

核心原理 #

API Gateway默认和Lambda集成时用的是RequestResponse模式（等待Lambda执行完再返回响应），但我们可以通过配置把它改成Event模式——这种模式下API Gateway会立刻给调用方返回响应，Lambda则在后台独立执行，完美匹配你的需求。

Serverless框架配置步骤 #

1. 在serverless.yml中配置Lambda的HTTP事件为Event模式 #

在你的函数定义里，针对HTTP事件添加integration: lambda，并指定invocationType: Event，具体配置示例如下：

service: github-webhook-service

provider:
  name: aws
  runtime: nodejs18.x # 根据你的实际运行时调整

functions:
  githubWebhookHandler:
    handler: src/handler.webhook # 你的Lambda处理函数路径
    events:
      - http:
          path: webhook/github
          method: post
          integration: lambda # 必须指定为lambda集成才能配置调用类型
          request:
            invocationType: Event # 关键配置：启用即发即弃模式

2. 自定义API Gateway的响应内容 #

默认情况下，Event模式下API Gateway会返回202 Accepted给调用方，但如果你想给GitHub返回更友好的确认消息（比如告诉它Webhook已收到），可以添加响应模板配置：

# 接上面的http事件配置
response:
  statusCode: 200
  headers:
    Content-Type: application/json
  template: |
    {"status": "success", "message": "Webhook received, processing in background"}

这样GitHub会立刻收到200 OK和自定义的JSON响应，不会因为等待Lambda执行而触发重试机制。

重要注意事项 #

• Lambda超时设置：Event模式下Lambda的执行不受API Gateway的超时限制（API Gateway默认最大30秒），你可以根据任务耗时把Lambda的超时时间设到最大15分钟（在provider或函数级别配置timeout: 900）。
• 日志排查：Lambda的执行日志依然会保存在CloudWatch Logs里，方便你排查后台执行的问题。
• GitHub Webhook重试：GitHub如果在10秒内没收到响应会重试，用Event模式能彻底避免这个问题，因为API Gateway会立即返回。

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