Go函数部署失败主因是构建环境与平台不匹配：需CGO_ENABLED=0、GOOS=linux、GOARCH匹配平台，用aws-lambda-go封装符合签名的handler，阿里云FC还需适配Alpine Linux并规范入口文件名。
Go 语言写 Serverless 函数本身很轻量，但部署失败往往不是因为代码写得不对，而是环境、打包方式或平台约束没对上。
为什么 go build 默认产物不能直接上传到 AWS Lambda？
AWS Lambda 要求可执行文件是静态链接、无 CGO 依赖、且运行在 Amazon Linux 2（或 AL2023）环境。本地 macOS 或 Windows 上直接 go build 出来的二进制会动态链接 libc，Lambda 启动时直接报 exec format error 或 no such file or directory。
- 必须显式关闭 CGO：
CGO_ENABLED=0 go build -o main main.go - 目标 OS 和 ARCH 要匹配 Lambda 运行时：
GOOS=linux GOARCH=amd64（或arm64） - 如果用了
net/http、crypto/tls等包，确保 Go 版本 ≥ 1.20（TLS 根证书行为更稳定）
如何用 aws-lambda-go 正确封装 handler？
Go 的 Lambda handler 不是任意函数都能接——必须符合 lambda.Start 接受的签名。常见错误是把 http.HandlerFunc 直接传进去，或者漏了 context.Context 参数。
- 标准入口写法：
lambda.Start(handler)，其中handler类型应为func(context.Context, events.APIGatewayV2HTTPRequest) (events.APIGatewayV2HTTPResponse, error) - 别用
http.ListenAndServe：Serverless 没有长驻进程，不监听端口 - 如果只是处理简单事件（如 SQS、S3），用对应
events子包类型，别硬套 HTTP 结构
示例最小可行 handler：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
package main
<p>import (
"context"
"github.com/aws/aws-lambda-go/events"
"github.com/aws/aws-lambda-go/lambda"
"github.com/aws/aws-lambda-go/lambdacontext"
)</p><p>func handler(ctx context.Context, req events.APIGatewayV2HTTPRequest) (events.APIGatewayV2HTTPResponse, error) {
return events.APIGatewayV2HTTPResponse{
StatusCode: 200,
Body: "hello",
}, nil
}</p><p>func main() {
lambda.Start(handler)
}阿里云 FC（函数计算）部署 Go 函数要注意什么？
阿里云 FC 对 Go 支持更“宽松”，但也埋了几个坑：它默认用 go run 启动，不强制要求预编译；但一旦你上传二进制，就必须满足其 runtime 环境约束，否则报 fork/exec /var/task/main: no such file or directory。
- FC 的 Go runtime 实际是基于 Alpine Linux，所以即使关了 CGO，仍可能因缺少
musl兼容性出错 —— 建议加-ldflags="-s -w"并用GOOS=linux GOARCH=amd64 CGO_ENABLED=0构建 - 入口函数名必须是
main，且 handler 文件必须叫main.go（FC 控制台不认其他文件名） - 如果用
fun deploy工具，确保template.yml中Runtime设为go1.x，且Handler是main::main（注意双冒号）
本地调试和日志怎么不被线上绕过？
Lambda 和 FC 都会注入 context，但本地测试时容易忽略日志输出被吞掉，或误判超时逻辑。
- 用
log.Printf而非fmt.Println：Lambda 日志自动捕获stderr，log默认走 stderr - 本地调试建议加一层 wrapper：
if os.Getenv("AWS_LAMBDA_RUNTIME_API") == "" { lambda.Start(testHandler) }，避免本地跑不起来 - 超时设置要和平台一致：Lambda 默认 3 秒，FC 默认 60 秒——代码里别硬写
time.Sleep(5 * time.Second)就以为能过
最常被跳过的其实是构建环境一致性：CI/CD 流水线里用 Ubuntu 构建，却忘了设 GOOS 和 CGO_ENABLED，导致每次上线都报 exec 错误。不是代码问题，是构建链路断了。
