Python版AWS Lambda函数模板的event参数指定及POST请求问题

别担心，基础问题完全没问题——谁都是从接触Lambda的第一个POST请求开始卡壳的！我来一步步给你讲清楚event参数到底是什么，以及在处理POST请求时怎么用它。

1. event参数到底是什么？ #

Lambda的event参数其实是触发Lambda的事件数据容器——不管是API Gateway的HTTP请求、S3的文件上传，还是其他触发器，所有的触发数据都会打包进这个参数里。对于API Gateway的POST请求来说，event里会包含请求的所有细节：请求头、查询参数、请求体、路径参数等等。

2. POST请求下event的核心结构 #

当你用API Gateway的POST端点触发Lambda时，event在Python里是一个字典，核心结构大概长这样：

{
  "resource": "/your-endpoint-path",
  "httpMethod": "POST",
  "headers": {
    "Content-Type": "application/json",
    # 其他请求头比如Authorization、Host等都会在这里
  },
  "body": '{"username": "test", "email": "test@example.com"}',  # 划重点：这里是JSON字符串！
  "isBase64Encoded": False
}

这里要特别注意：POST的请求体默认是JSON字符串格式，不是直接可用的Python字典，你需要自己解析它。

3. 处理POST请求的Lambda代码示例 #

直接上实用的Python代码，你可以照着改：

import json

def lambda_handler(event, context):
    # 第一步：解析POST请求体
    # 先判断请求是否是JSON格式（大部分场景都是）
    content_type = event["headers"].get("Content-Type", "")
    if "application/json" in content_type:
        # 把JSON字符串转换成Python字典
        try:
            request_body = json.loads(event["body"])
        except json.JSONDecodeError:
            return {
                "statusCode": 400,
                "body": json.dumps({"message": "请求体不是合法的JSON格式"})
            }
    else:
        # 如果是表单数据（比如x-www-form-urlencoded），需要用urllib.parse解析，这里先给基础版
        return {
            "statusCode": 400,
            "body": json.dumps({"message": "当前只支持JSON格式的请求体"})
        }
    
    # 第二步：使用解析后的数据做业务操作
    username = request_body.get("username")
    email = request_body.get("email")
    
    # 第三步：返回符合API Gateway要求的响应格式
    return {
        "statusCode": 200,
        "headers": {
            "Content-Type": "application/json"
        },
        "body": json.dumps({
            "message": "POST请求处理成功！",
            "received_username": username,
            "received_email": email
        })
    }

4. Serverless框架的配置注意点 #

如果你用Serverless.yml配置你的端点，只要确保函数绑定了POST方法就行，比如：

functions:
  myPostHandler:
    handler: handler.lambda_handler  # 对应你的代码文件（handler.py）和函数名
    events:
      - httpApi:
          path: /user
          method: post

这样配置后，当你向/user发送POST请求时，API Gateway就会自动把请求的所有数据打包成event参数传给你的Lambda函数。

几个常见小坑提醒 #

• 千万别忘了event["body"]是字符串，一定要用json.loads()解析，不然直接取键会报错！
• 如果isBase64Encoded字段为True，说明请求体是Base64编码的，你需要先解码再解析：import base64; decoded_body = base64.b64decode(event["body"]); request_body = json.loads(decoded_body)
• 测试的时候用Postman或者curl发请求，记得设置请求头Content-Type: application/json，请求体用标准JSON格式。

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