Go语言AWS Lambda无API Gateway的Function URL适配与报错排查

502 Bad Gateway 错误原因 #

返回502的核心原因是事件结构不匹配：当前代码使用的events.APIGatewayProxyRequest是API Gateway REST API代理集成对应的事件结构，Function URL触发Lambda时传递的事件载荷格式和该结构不兼容，Lambda无法正确解析入参、返回结果也不符合Function URL的格式要求，就会抛出502错误。

Function URL 对HTTP方法的识别逻辑 #

• Function URL不需要单独配置指定支持的HTTP方法，默认全量支持GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS所有标准HTTP方法
• 你在Postman等客户端发起请求时使用的HTTP方法，会被自动封装到传入Lambda的事件对象中，直接读取事件对应字段即可判断请求方法，做分支处理。

Function URL 对应的对等事件结构 #

AWS Go SDK提供了专门适配Function URL触发场景的事件/返回结构，和API Gateway场景的events.APIGatewayProxyRequest/events.APIGatewayProxyResponse完全对等：

• 入参结构：events.LambdaFunctionURLRequest
• 返回结构：events.LambdaFunctionURLResponse

适配修改后的可运行代码 #

package main

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

func handleRequest(ctx context.Context, request events.LambdaFunctionURLRequest) (events.LambdaFunctionURLResponse, error) {
	// 读取请求HTTP方法
	reqMethod := request.RequestContext.HTTP.Method

	// 示例：仅允许GET请求的逻辑
	if reqMethod != "GET" {
		return events.LambdaFunctionURLResponse{
			StatusCode: 405,
			Body:       "Method Not Allowed",
		}, nil
	}

	// 业务逻辑可从以下字段取请求数据：
	// 1. Query参数：request.QueryStringParameters
	// 2. 路径参数：request.PathParameters
	// 3. 请求头：request.Headers
	// 4. 请求体：request.Body
	return events.LambdaFunctionURLResponse{
		StatusCode: 200,
		Body:       request.Body,
		Headers: map[string]string{
			"Content-Type": "text/plain",
		},
	}, nil
}

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

补充说明 #

• 如果需要配置跨域，可以直接在Lambda控制台的Function URL配置页设置CORS规则，无需在代码中单独处理OPTIONS请求，也可以根据需求在代码中自定义跨域逻辑
• 如果需要同时兼容API Gateway和Function URL两种触发源，可以使用events.APIGatewayV2HTTPRequest作为入参，该结构同时适配两类触发源的载荷格式。

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