gin.Default()不适合生产环境，因其默认启用Logger和Recovery中间件，易导致高并发性能瓶颈、敏感信息泄露及调试模式暴露；应改用gin.New()自定义中间件并显式配置。
别用 gin.Default() 直接打包，它埋的坑在 CI/CD 里才爆出来。 你本地跑得通，镜像一推就 panic，多半是中间件隐式加载、日志格式错乱、或 context 生命周期失控导致的。真正可控的打包流程，核心是「构建可复现、运行可观察、关机可等待」三件事。
go build 命令必须带 -ldflags 控制二进制元信息
不加 -ldflags 的二进制无法区分 dev/staging/prod 环境，也难排查版本来源：
-
go build -ldflags="-X main.version=$(git describe --tags --always) -X main.commit=$(git rev-parse HEAD) -X main.date=$(date -u +'%Y-%m-%dT%H:%M:%SZ')"—— 把 Git 版本、提交哈希、构建时间注入到变量里 - 在代码里声明
var version, commit, date string，然后通过/healthz或GET /version暴露出来，CI 流水线能自动校验镜像是否匹配 tag - 避免用
runtime/debug.ReadBuildInfo()动态读取——它在静态链接（CGO_ENABLED=0）下不可靠，且无法覆盖-ldflags注入的值
Docker 多阶段构建要拆开 build 和 run 阶段，且 runtime 镜像不能用 alpine
alpine 的 musl libc 在 DNS 解析、TLS 握手、或某些 net 包调用时会静默失败，尤其在 K8s 内网访问 etcd 或 Redis 时：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- build 阶段用
golang:1.23-alpine或官方golang:1.23（推荐后者，兼容性更稳） - run 阶段必须用
debian:slim或ubuntu:24.04-slim，而不是alpine:latest -
COPY --from=builder /workspace/myapp /usr/local/bin/myapp后，立刻RUN chmod +x /usr/local/bin/myapp，否则容器启动报exec format error - entrypoint 写成
ENTRYPOINT ["/usr/local/bin/myapp"]，别用shell form，否则信号转发失效，优雅关机收不到SIGTERM
main.go 里必须实现优雅关机，且超时时间要显式设为 10s
云平台（如 AWS ECS、K8s）发 SIGTERM 后只给 10–30 秒清理窗口，超时直接 kill -9，连接被断、事务未提交、Redis 连接泄漏全在这儿发生：
立即学习“go语言免费学习笔记（深入）”；
- 用
http.Server显式管理服务生命周期，别依赖router.Run() -
srv := &http.Server{Addr: ":8080", Handler: r}，然后go func() { srv.ListenAndServe() }() - 监听
os.Interrupt和syscall.SIGTERM，调用srv.Shutdown(context.WithTimeout(context.Background(), 10*time.Second)) - 关机前调用
redisClient.Close()、db.Close()，这些操作必须在Shutdown的 context 超时内完成，否则会被强制终止
最常被跳过的其实是 go mod vendor 和 CGO_ENABLED=0 的组合——它决定了你的二进制能不能在任意 Linux 发行版上运行。一旦用了 net 包做自定义 DNS 查询，或者依赖 cgo 的 SQLite 驱动，没关 CGO 就打包，镜像在不同基础镜像上行为可能完全不一致。
