本地调试 AWS Lambda Go 函数必须改用 http.ListenAndServe 启动 HTTP 服务，而非默认阻塞等待 runtime API；需手动判断环境变量分流逻辑，避免 base64 编码 body 导致解析失败，并优先使用官方 Lambda Docker 镜像模拟真实环境。
用 aws-lambda-go 启动本地调试前必须改掉的默认行为
Go 的 Lambda runtime 默认会监听 Unix socket 或 AWS 内部 endpoint，本地跑不起来——它压根不启动 HTTP 服务。想用 curl 或 Postman 测试，得手动启用 lambda.StartHandler 的调试模式，或者换用 lambda.Start 配合自定义入口。
- 别直接跑
go run main.go：默认行为是阻塞等待 Lambda service 拉取事件，本地没 service，就卡死 - 加个环境变量开关：
LAMBDA_TASK_ROOT=/tmp和AWS_LAMBDA_RUNTIME_API=127.0.0.1:9001是 mock runtime 所需，但 Go SDK 不自动读这些；得自己判断os.Getenv("AWS_LAMBDA_RUNTIME_API") == ""来分流逻辑 - 推荐做法：写一个
main()分支，本地走http.ListenAndServe(":8080", handler)，线上才调lambda.Start；别试图“一套代码通吃”，Go 的编译期绑定太硬
lambda.Start 和 lambda.StartHandler 的参数差异直接影响调试路径
这两个函数看着像只是签名不同，实际触发的执行链路完全不同：前者强制走 AWS runtime API 协议（需要 awslambdaruntime），后者是旧版直接传 event 的方式，本地 mock 更简单。
-
lambda.StartHandler接收func(context.Context, events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error)，适合本地起一个http.HandlerFunc包装后直连，event 结构可手写 JSON 构造 -
lambda.Start要求函数签名为func(context.Context, []byte) ([]byte, error)，所有序列化/反序列化甩给 runtime，本地调试时你得自己模拟POST /2015-03-31/functions/function/invocations请求体格式 - 如果你用
serverless-go或aws-serverless-go这类封装库，注意它们内部是否悄悄替换了 handler 类型——有些会把APIGatewayProxyRequest自动转成[]byte，导致本地和线上解包不一致
本地调试时 events.APIGatewayProxyRequest 的 body 字段容易被忽略的编码陷阱
Go 的 events.APIGatewayProxyRequest 中 Body 是 string 类型，但真实 Lambda 里它可能是 base64 编码过的二进制数据（尤其启用了二进制媒体类型时），本地调试如果直接填 raw JSON 字符串，线上就会 panic。
- 检查
IsBase64Encoded字段：本地测试时设为false，线上由 API Gateway 控制；别假设它永远是false - body 解析不能直接
json.Unmarshal([]byte(req.Body), &v)：如果IsBase64Encoded == true，得先base64.StdEncoding.DecodeString(req.Body) - 常见错误现象：
invalid character '' looking for beginning of value—— 就是 base64 没解码直接当 UTF-8 字符串用了
用 docker run 模拟真实 Lambda 环境比 go run 更可靠
本地 go run 缺少 /var/task、/tmp 权限限制、cgroup 内存限制等关键约束，很多 bug 到线上才暴露。AWS 官方提供了 public.ecr.aws/lambda/go 镜像，应该优先用它。
立即学习“go语言免费学习笔记（深入）”；
- 构建命令示例：
docker build -t myfunc . && docker run -p 9000:8080 -e AWS_LAMBDA_RUNTIME_API=127.0.0.1:9001 myfunc - 镜像内
/var/runtime/bootstrap是真实 runtime 入口，你的main必须导出为可执行文件（不是源码），且路径要设对：CMD ["/var/task/main"] - 别漏掉
GOOS=linux GOARCH=amd64交叉编译：Mac 上go build默认是 darwin，容器里直接 exec format error
真正麻烦的是 context timeout 和内存限制——本地跑得再快，也掩盖不了线上 3s 超时或 128MB 内存下 json.Marshal 失败的问题。这些只能靠容器+真实 runtime 暴露出来。
