生产环境必须打包成静态二进制并放入容器，且必须映射端口才能对外可见；需设CGO_ENABLED=0、GOOS=linux确保Alpine兼容，否则报“no such file or directory”；Dockerfile须多阶段构建，仅复制二进制，加ca-certificates，并显式注册/health路由。
直接跑 go run main.go 只能本地调试，生产环境必须打包成二进制再放进容器，且容器端口不映射就等于“对外不可见”——这是 Gin 部署失败最常被忽略的两个硬性前提。
构建静态二进制时必须禁用 CGO
Go 编译出的可执行文件要能在 Alpine 等精简镜像里直接运行，就得是纯静态链接。否则容器启动会报 standard_init_linux.go:228: exec user process caused: no such file or directory（本质是找不到 libc）。
-
CGO_ENABLED=0是强制关闭 C 语言交互，确保不依赖系统 libc -
GOOS=linux和GOARCH=amd64（或arm64）用于交叉编译，适配目标服务器架构 - 命令顺序要写对：Linux/macOS 用
CGO_ENABLED=0 GOOS=linux go build -o app .；Windows PowerShell 需分三行设环境变量，CMD 则用set CGO_ENABLED=0 && set GOOS=linux && go build -o app .
Dockerfile 必须用多阶段构建
直接 FROM golang 打包再运行，镜像动辄 900MB+，全是开发工具和源码，既不安全又浪费资源。生产镜像应该只含运行时依赖。
- 构建阶段用
golang:1.21-alpine下载依赖、编译二进制 - 运行阶段切到
alpine:latest或更小的scratch（但需确认无 DNS 解析等依赖） -
COPY --from=builder只复制编译产物，不带go.mod、main.go等源文件 - 别漏掉
RUN apk --no-cache add ca-certificates，否则 HTTPS 请求（如调第三方 API）会因证书缺失失败
容器端口映射不是可选项，而是访问通路本身
Gin 默认监听 :8080，但这只是容器内部端口。宿主机根本看不到它，除非显式映射。
-
docker run -p 8080:8080 your-app：把宿主机 8080 映射到容器 8080，浏览器才能打开http://localhost:8080/hello - 若想用 80 端口对外服务，得写
-p 80:8080，注意宿主机 80 端口是否被 nginx/apache 占用 - Kubernetes 场景下，
containerPort必须和 Ginr.Run(":8080")的端口一致，否则livenessProbe会失败 - 防火墙（如 ufw、firewalld）和云服务器安全组也要放行对应端口，否则映射了也连不通
健康检查路径必须真实存在且不带重定向
很多教程随便写个 /health，但 Gin 默认没注册这个路由，K8s 探针就会持续失败并重启容器。
- 在
main.go里加一行：r.GET("/health", func(c *gin.Context) { c.Status(200) }) - 不要用
c.Redirect或中间件跳转，探针只认 2xx 响应体为空的直连响应 - 避免在
/health里查数据库或远程服务，否则探针超时或误判为异常 - 如果用了反向代理（如 Nginx），确保它不缓存
/health响应，否则 K8s 看到的永远是旧状态
最容易被跳过的其实是环境一致性：本地 go run 能通，不代表容器里也能通——Gin 的 r.Run() 默认绑定 0.0.0.0:8080 没问题，但如果你代码里手写成了 127.0.0.1:8080，容器网络就彻底失联了。
