如何解决AWS Lambda与API Gateway中event.path引发的400状态码问题

问题根源在于：当调用带阶段前缀的API端点时，Lambda收到的event.path会包含阶段名称（比如/develop/states），但你的路由匹配逻辑是基于API Gateway中定义的原始路径（比如/states），两者不匹配就会返回400错误。

以下是几种可行的解决方法：

方法1：在Lambda中动态移除阶段前缀 #

从event.requestContext.stage获取当前阶段名称，然后从event.path中剔除这个前缀，再进行路由匹配。以Python为例：

import re

def lambda_handler(event, context):
    # 获取当前阶段名称
    stage = event['requestContext']['stage']
    # 移除阶段前缀，得到原始路由路径
    cleaned_path = re.sub(f'^/{stage}', '', event['path'])
    
    # 基于清理后的路径做路由判断
    if cleaned_path == '/countries' and event['httpMethod'] == 'GET':
        # 实现获取所有国家的逻辑
        return {
            'statusCode': 200,
            'body': '[{"name": "China"}, {"name": "United States"}]'
        }
    elif cleaned_path == '/states' and event['httpMethod'] == 'POST':
        # 实现根据国家获取州的逻辑
        country_data = event['body']
        return {
            'statusCode': 200,
            'body': '[{"name": "Guangdong"}, {"name": "Shanghai"}]'
        }
    else:
        return {
            'statusCode': 400,
            'body': '无效端点'
        }

这种方法适配所有阶段名称，无需硬编码，灵活性更高。

方法2：通过API Gateway映射模板修改传入Lambda的路径 #

在API Gateway的集成请求中配置映射模板，直接将path字段替换为API Gateway定义的原始资源路径，避免Lambda处理阶段前缀：

1. 进入API Gateway控制台，找到你的API和对应阶段
2. 进入目标资源（比如/states）的集成请求设置
3. 添加application/json类型的映射模板，输入以下内容：

{
  "path": "$context.resourcePath",
  "httpMethod": "$context.httpMethod",
  "body": $input.json('$'),
  "requestContext": $util.toJson($context.requestContext)
}

这样Lambda收到的event.path就是API Gateway中定义的资源路径（比如/states），无需额外处理即可直接匹配路由。

方法3：针对API Gateway V2调整字段 #

如果使用的是API Gateway V2，event结构略有不同：

• 包含阶段的完整路径在rawPath字段中
• 阶段名称依然在requestContext.stage中
  修改Lambda逻辑适配即可：

import re

def lambda_handler(event, context):
    stage = event['requestContext']['stage']
    cleaned_path = re.sub(f'^/{stage}', '', event['rawPath'])
    # 后续路由逻辑同方法1

注意事项 #

• 调试时可以先打印完整的event内容，确认path/rawPath和stage字段的具体值，确保处理逻辑正确
• 避免硬编码阶段名称，否则后续新增或修改阶段时需要同步修改Lambda代码

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