使用Gin、API Gateway、Serverless Framework与Lambda时路径无法识别

1. 代码层面：切换Lambda事件处理模式 #

你的当前代码用gateway.ListenAndServe(":8080", setupRouter())是本地调试写法，部署到Lambda时需改为适配Lambda事件的处理逻辑，借助aws-lambda-go-api-proxy库的适配器完成API Gateway事件到Gin请求的转换：

修改main函数（适配REST API v1）：

func main() {
    r := setupRouter()
    adapter := gateway.NewAPIGatewayProxyAdapter(r)
    lambda.Start(adapter)
}

如果使用HTTP API v2，改用V2适配器：

func main() {
    r := setupRouter()
    adapter := gateway.NewV2HTTPAdapter(r)
    lambda.Start(adapter)
}

2. Serverless配置文件：正确配置API Gateway路由集成 #

针对REST API（v1） #

配置http事件，用通配符路径将所有请求转发到Lambda，确保Gin能识别完整路由：

service: gin-lambda-api

provider:
  name: aws
  runtime: go1.x
  region: us-east-1 # 替换为你的AWS区域

functions:
  ginApi:
    handler: bin/main # 编译后的二进制文件路径
    events:
      - http:
          path: /{proxy+} # 通配所有子路径
          method: ANY # 匹配所有HTTP方法
          cors: true # 按需启用跨域

针对HTTP API（v2） #

使用httpApi事件配置全局通配路由：

service: gin-lambda-api

provider:
  name: aws
  runtime: go1.x
  region: us-east-1

functions:
  ginApi:
    handler: bin/main
    events:
      - httpApi:
          path: '/*' # 通配所有路径
          method: ANY
          cors: true

3. 路径前缀适配（可选） #

如果API Gateway配置了stage（比如/dev），Gin会把/dev/hello-world当作完整路径导致路由不匹配，可添加中间件去除stage前缀：

func setupRouter() *gin.Engine {
    r := gin.Default()

    // 中间件：去除第一个路径段（假设是stage）
    r.Use(func(c *gin.Context) {
        parts := strings.Split(c.Request.URL.Path, "/")
        if len(parts) > 2 {
            c.Request.URL.Path = "/" + strings.Join(parts[2:], "/")
        }
        c.Next()
    })

    r.GET("/", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"message": "/ hello test completed successfully"})
    })
    r.GET("/hello-world", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"message": "/hello-world hello test completed successfully"})
    })

    return r
}

4. 编译与部署注意事项 #

• 编译Go代码需针对Linux环境：GOOS=linux GOARCH=amd64 go build -o bin/main main.go
• 确保Serverless Framework为最新版本：npm install -g serverless

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