Go部署需统一GOOS/GOARCH并控制CGO_ENABLED：静态编译用CGO_ENABLED=0，启用cgo则需目标平台开发库；加-ldflags="-s -w"去调试信息，file和ldd验证静态性；配置用环境变量而非硬编码；主进程需显式处理SIGTERM以优雅关闭。
确认 Go 编译目标平台和 CGO 状态
Go 项目部署前最常踩的坑是本地能跑、线上报错，根源往往在 GOOS/GOARCH 和 CGO_ENABLED 不一致。比如你在 macOS 开发，但目标服务器是 Linux AMD64，且项目依赖了 cgo（如用 net 包做 DNS 解析、或用了 sqlite3），不显式控制就会编译出带本地 C 运行时依赖的二进制，上线后直接 exec format error 或 lib not found。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 统一用交叉编译：运行
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o myapp .（CGO_ENABLED=0关闭 cgo 可生成纯静态二进制，适用于绝大多数 HTTP 服务） - 若必须启用 cgo（如调用系统 OpenSSL 或某些驱动），则需在目标环境安装对应开发库（如
libc6-dev、libssl-dev），并确保CC指向目标平台的交叉编译器（如x86_64-linux-gnu-gcc） - 检查依赖是否含 cgo：运行
go list -json | jq '.CgoFiles'或直接看go build -x输出里有没有gcc调用
剥离调试信息并验证二进制可执行性
默认编译的 Go 二进制包含 DWARF 调试符号，体积大、有泄露源码路径风险，且部分安全策略会拦截带调试段的可执行文件。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 加
-ldflags="-s -w"编译：其中-s去除符号表，-w去除 DWARF 信息 - 验证是否真静态：运行
file myapp，输出应含statically linked；再用ldd myapp，应返回not a dynamic executable - 在目标机器上直接
./myapp测试启动，别只信chmod +x—— 有些镜像（如scratch）连/bin/sh都没有，只能靠直接执行
配置管理不能硬编码，优先用环境变量
Go 没有内置的配置加载机制，新手常把数据库地址、端口写死在代码里，导致每次部署都要改代码、重新编译。这违背不可变基础设施原则，也容易引发测试/生产配置混用。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Getenv()读取环境变量，配合flag.StringVar提供命令行 fallback（如PORT默认从os.Getenv("PORT")读，未设置则 fallback 到"8080"） - 避免使用第三方配置库（如
viper）—— 它引入 YAML/JSON 解析依赖，还可能触发 cgo（某些版本的viper依赖github.com/mitchellh/go-homedir，而后者在 Windows 下会调用 cgo） - 敏感配置（如密码）绝不写进镜像层：通过容器
env_file、K8sSecret或 systemdEnvironmentFile注入，而非构建时ENV指令
进程守护与信号处理要显式支持
Go 程序默认不响应 SIGTERM，容器或 systemd 发送停止信号后，进程不会优雅关闭监听 socket、释放连接池，导致请求中断或连接泄漏。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
signal.Notify监听os.Interrupt和syscall.SIGTERM，收到后调用http.Server.Shutdown()（如果有 HTTP server） - 主 goroutine 不要直接
log.Fatal()退出，而是用os.Exit(0)或让main()自然返回 - 若用 systemd 部署，确保
service文件中设置了Type=simple（Go 进程自己是主进程）或Type=notify（配合github.com/coreos/go-systemd/v22/sdnotify）
func main() {
srv := &http.Server{Addr: ":8080", Handler: handler}
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)
<-sigChan
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal(err)
}
}
真正麻烦的不是写这几行代码，而是很多人压根没意识到 Go 进程需要自己处理信号 —— 它不像 Node.js 或 Python 的某些框架会自动注册 SIGTERM 处理器。
