CloudFront调用Lambda Function URL的事件Schema及查询参数获取问题

核心原因与关键结论 #

当CloudFront将请求转发到Lambda Function URL时，Lambda收到的仍然是标准的Lambda Function URL事件格式，而非CloudFront专属事件类型。你遇到的参数无法获取问题，大概率是自定义结构体的字段映射错误，或是CloudFront的参数转发配置存在疏漏。

分步解决方案 #

1. 替换为官方Lambda Function URL事件结构体 #

不要使用自定义的Request结构体，直接采用AWS官方Go SDK提供的events.LambdaFunctionURLRequest，它完全匹配Lambda Function URL的事件格式，避免字段映射错误。

示例代码：

package main

import (
    "context"
    "github.com/aws/aws-lambda-go/events"
    "github.com/aws/aws-lambda-go/lambda"
)

func handler(ctx context.Context, req events.LambdaFunctionURLRequest) (events.LambdaFunctionURLResponse, error) {
    // 直接从官方结构体获取查询参数
    testValue := req.QueryStringParameters["test"]
    
    // 也可以通过原始查询字符串解析（适用于复杂参数场景）
    // rawQuery := req.RawQueryString
    // params, _ := url.ParseQuery(rawQuery)
    // testValue := params.Get("test")

    return events.LambdaFunctionURLResponse{
        StatusCode: 200,
        Body:       "获取到的test参数值：" + testValue,
    }, nil
}

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

2. 验证CloudFront的参数转发配置 #

确保CloudFront的源请求策略正确配置：

• 确认已设置为「转发所有查询字符串」，而非仅转发指定参数或不转发
• 检查缓存策略是否未对查询参数进行过滤（如果启用了缓存）

3. 排查步骤 #

• 跳过CloudFront直接测试：直接访问Lambda Function URL并携带查询参数，查看是否能正常获取参数。如果可以，说明问题出在CloudFront转发环节；如果不行，说明Lambda的事件解析逻辑有误。
• 打印完整事件日志：在Lambda代码中打印接收到的原始事件JSON，确认查询参数实际存在于哪个字段中，以此验证结构体映射是否正确。

关键说明 #

CloudFront作为HTTP客户端向Lambda Function URL发起请求，因此Lambda收到的事件格式与直接访问Function URL时完全一致，无需寻找CloudFront专属的Lambda事件类型。官方的events.LambdaFunctionURLRequest结构体是唯一需要的类型。

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