Amazon API Gateway HTTP API场景下Go语言Lambda函数自定义类型传参疑问

一、自定义类型接收不到参数的原因及解决方法 #

你遇到的问题核心在于HTTP API Payload Format Version 2的请求结构是被包装过的——Lambda收到的不是直接的请求Body JSON，而是一个包含请求元数据、Body、Headers等字段的完整结构体。直接用MyRequestType作为handler入参时，Lambda的序列化器无法从包装后的请求中提取Body内容并映射到你的自定义类型，所以才会得到默认的空字符串和0值。

解决方法有两种： #

方法1：使用官方events.APIGatewayV2HTTPRequest作为入参，手动解析Body

修改handler签名，先接收完整的网关请求结构体，再将Body字段反序列化为你的自定义类型：

import (
    "context"
    "encoding/json"
    "fmt"
    "log"

    "github.com/aws/aws-lambda-go/events"
    "github.com/aws/aws-lambda-go/lambda"
)

type MyRequestType struct { 
    Name string `json:"name"` 
    Age int `json:"age"` 
} 

type MyResponseType struct { 
    Message string `json:"message"` 
} 

func handler(ctx context.Context, req events.APIGatewayV2HTTPRequest) (events.APIGatewayV2HTTPResponse, error) {
    var myReq MyRequestType
    err := json.Unmarshal([]byte(req.Body), &myReq)
    if err != nil {
        return events.APIGatewayV2HTTPResponse{
            StatusCode: 400,
            Body:       fmt.Sprintf("Failed to parse request: %v", err),
        }, err
    }

    log.Printf("received request: %v", myReq)
    responseBody, _ := json.Marshal(MyResponseType{
        Message: fmt.Sprintf("Hello %s, you are %d years old!", myReq.Name, myReq.Age),
    })

    return events.APIGatewayV2HTTPResponse{
        StatusCode: 200,
        Body:       string(responseBody),
        Headers: map[string]string{
            "Content-Type": "application/json",
        },
    }, nil
}

func main() { 
    lambda.Start(handler) 
}

方法2：调整API Gateway的Payload格式为V1（可选）

如果你希望直接接收原始Body作为入参，可以在API Gateway的集成设置中，将Payload Format Version改为1.0。不过注意，V1格式的请求结构和V2不同，且HTTP API默认推荐使用V2，所以更建议用方法1适配V2格式。

二、关于Payload V2的Handler签名疑问 #

1. context.Context是标准Go Context吗？ #

是的！Handler签名中的第一个参数context.Context是Go标准库context包中的标准Context类型，它不是events.APIGatewayV2HTTPRequestContext。后者是events.APIGatewayV2HTTPRequest结构体中的一个字段，用来存储请求的网关特定元数据（比如请求ID、认证信息等），而标准Context主要用于传递超时、取消信号以及请求级别的元数据。

2. 正确的TIn和TOut类型是什么？ #

对于Payload Format Version 2的HTTP API：

• TIn：推荐使用events.APIGatewayV2HTTPRequest，这个结构体完整映射了HTTP API发送给Lambda的所有请求数据（包括Body、Headers、QueryStringParameters、RequestContext等）。
• TOut：可以使用events.APIGatewayV2HTTPResponse，它能让你方便地设置状态码、Headers和响应Body；当然你也可以返回自定义类型（比如你的MyResponseType），但此时Lambda会自动将其序列化为JSON，并默认返回200状态码，不过这种方式无法自定义Headers或非200的状态码，所以复杂场景下更推荐用官方的响应结构体。

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