如何配置AWS Lambda与API Gateway代理集成使用APIGatewayProxyEventV2

方案一：使用API Gateway HTTP API（原生支持V2事件） #

HTTP API是API Gateway的V2版本服务，默认会向Lambda发送APIGatewayProxyEventV2格式的事件（包含rawPath字段），配置步骤如下：

• 登录AWS控制台，进入API Gateway服务
• 点击「创建API」，选择「HTTP API」类型，点击「构建」
• 填写API名称等基本信息后，进入「路由」配置页，点击「添加路由」
• 设置路由的请求方法（如GET、POST）和路径，在「集成目标」中选择「Lambda函数」
• 选中你的目标Lambda函数，确认勾选「使用Lambda代理集成」（HTTP API默认采用V2事件格式，无需额外调整）
• 部署API到指定阶段（如prod），之后通过HTTP API的调用地址触发Lambda，即可收到符合预期的V2格式事件

方案二：在现有REST API中启用V2格式代理集成 #

如果需要保留原有的REST API，可修改集成设置切换到V2事件格式：

• 进入目标REST API的资源管理页面，找到已配置Lambda代理集成的资源
• 点击该资源的「集成请求」选项
• 在「集成类型」区域，找到「Lambda代理集成」的设置项，勾选「使用Lambda代理集成V2格式」
• 保存配置后，重新部署API到对应阶段，触发后Lambda将收到带rawPath的V2格式事件

额外注意 #

确保你的Lambda代码中导入的是对应语言的V2版本事件类型，比如：

• Java：software.amazon.awssdk.services.lambda.runtime.events.APIGatewayProxyEventV2
• Python：from aws_lambda_powertools.utilities.data_classes import APIGatewayProxyEventV2

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