APIGatewayV2HTTPRequest缺失RequestContext，CORS配置遇阻

问题分析 #

你的核心问题是Lambda接收的APIGatewayV2HTTPRequest事件中RequestContext.HTTP字段未被填充，导致无法识别OPTIONS请求，进而无法正确配置CORS。这通常和API Gateway的集成配置或事件类型匹配有关。

解决步骤 #

1. 确认API Gateway类型与集成模式 #

• 确保你使用的是HTTP API（而非REST API），APIGatewayV2HTTPRequest仅对应HTTP API的事件格式。如果是REST API，需改用APIGatewayRequest类型。
• 检查HTTP API的集成是否为Lambda代理集成：只有代理集成会将完整的请求上下文（包括请求方法、路径等）传递给Lambda。若使用非代理集成，请求元数据不会被填充到RequestContext.HTTP中。

2. 检查路由与CORS配置 #

• 确保OPTIONS方法已被添加到目标路由中，且路由指向你的Lambda函数。
• 若选择手动处理CORS而非API Gateway自动CORS配置，需确保OPTIONS请求能被正确转发到Lambda。如果开启了自动CORS，API Gateway会直接返回OPTIONS响应，不会触发Lambda执行，此时无需在Lambda中处理OPTIONS。

3. 验证Lambda事件类型正确性 #

• 确认代码中导入的是正确的AWS Lambda Go SDK事件包：github.com/aws/aws-lambda-go/events，且处理函数的入参确实是events.APIGatewayV2HTTPRequest，而非V1版本的APIGatewayRequest。

4. 调试验证 #

• 使用API Gateway控制台的测试功能发送OPTIONS请求，查看Lambda日志中RequestContext.HTTP.Method是否被正确填充。
• 开启API Gateway的访问日志，检查请求是否完整转发到Lambda，是否存在请求元数据丢失的情况。

示例代码（处理CORS的Lambda函数） #

package main

import (
	"context"
	"log"

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

func handler(ctx context.Context, req events.APIGatewayV2HTTPRequest) (events.APIGatewayV2HTTPResponse, error) {
	// 打印请求方法，验证是否获取到
	log.Printf("Received request method: %s", req.RequestContext.HTTP.Method)

	// 处理OPTIONS请求，返回CORS头部
	if req.RequestContext.HTTP.Method == "OPTIONS" {
		return events.APIGatewayV2HTTPResponse{
			StatusCode: 200,
			Headers: map[string]string{
				"Access-Control-Allow-Origin":      "https://your-frontend-domain.com", // 替换为实际前端域名
				"Access-Control-Allow-Methods":     "GET, POST, PUT, DELETE, OPTIONS",
				"Access-Control-Allow-Headers":     "Content-Type, Authorization",
				"Access-Control-Allow-Credentials": "true",
			},
		}, nil
	}

	// 处理其他业务请求
	return events.APIGatewayV2HTTPResponse{
		StatusCode: 200,
		Headers: map[string]string{
			"Access-Control-Allow-Origin": "https://your-frontend-domain.com",
			"Content-Type":                "application/json",
		},
		Body: `{"status": "success", "data": "your-response-data"}`,
	}, nil
}

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

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