Go语言AWS Lambda本地运行报错及API Gateway调用500问题求助

问题 #

我尝试使用Go语言创建一个对接API Gateway的简单AWS Lambda函数，用于处理GET请求。我的main.go文件代码如下：

package main

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

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

func handler (request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
    log.Printf("hello world")
    response := events.APIGatewayProxyResponse{
        StatusCode: 200,
    Body: "hello world",
    }
    return response, nil
}

type User struct {
    Username string `json:"username"`
    Password string `json:"password"`
}

type ResponseBody struct {
    Message string `json:"username"`
}

我在AWS上创建了HTTP API并上传了编译后的代码压缩包，获取端点和路由后，用Postman及VS Code的Thunder Client测试均返回500内部服务器错误：

{
    "message": "Internal Server Error"
}

本地执行go run main.go时，出现错误提示：

2023/04/04 15:08:55 expected AWS Lambda environment variables [_LAMBDA_SERVER_PORT AWS_LAMBDA_RUNTIME_API] are not defined exit status 1

我使用的是最新版Ubuntu系统，目前陷入困境，请求帮助解决问题。

解决方案 #

1. 本地运行报错的解决方式 #

本地直接执行go run main.go会报错，因为Lambda运行时依赖AWS专属环境变量，本地默认不存在这些变量。要在本地测试Lambda函数，可通过以下方式：

• 安装AWS SAM CLI，编写template.yaml定义Lambda和API Gateway资源
• 执行sam local start-api启动本地模拟网关，复现AWS运行环境进行测试

2. 部署后500错误的排查与修复 #

(1) 修复代码语法问题

你的main.go中response结构体初始化存在缩进错误，Body字段未与StatusCode对齐，这会导致编译失败，进而引发Lambda执行报错：

response := events.APIGatewayProxyResponse{
    StatusCode: 200,
    Body:       "hello world", // 修正缩进，确保字段对齐
}

(2) 匹配Lambda运行时的编译配置

Lambda的Go运行时要求二进制文件适配Linux平台，Ubuntu下编译需指定环境变量：

GOOS=linux GOARCH=amd64 go build -o main main.go

编译完成后，将生成的main二进制文件直接压缩为zip包（不要嵌套在文件夹内）再上传至Lambda。

(3) 查看Lambda执行日志

登录AWS控制台，进入目标Lambda函数的监控页面，查看CloudWatch日志，日志中会显示具体的运行时错误（如编译失败、panic信息等），这是定位500错误最有效的方式。

(4) 检查API Gateway集成配置

• 确认API Gateway的路由请求方法为GET，且集成目标指向你的Lambda函数
• 验证API Gateway是否具备调用Lambda的权限：可通过Lambda的触发器配置自动生成权限，或手动为API Gateway的IAM角色添加lambda:InvokeFunction权限

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