Gin应用在Docker中启动失败主因是运行配置错误：未监听0.0.0.0导致外部不可访问、端口未正确映射、主goroutine未阻塞、配置未外置、健康接口缺失及未启用Release模式。
gin 应用在 Docker 下跑不起来，八成不是框架问题，而是镜像构建或运行时配置没对上。直接上生产级做法，绕开“本地能跑就以为容器也能跑”的坑。
为什么 gin.Default() 在容器里启动失败？
常见现象是容器秒退、日志空、docker logs 无输出，或者报错 listen tcp :8080: bind: address already in use（其实是端口没暴露或被占）。
根本原因：Gin 默认监听 :8080，但容器内没有显式绑定到 0.0.0.0，或宿主机端口未映射，或应用启动后立即退出（比如没加 http.ListenAndServe 阻塞）。
- 确保启动代码使用
r.Run(":8080")—— 这等价于http.ListenAndServe(":8080", r)，会阻塞主 goroutine - 不要写
r.Run("127.0.0.1:8080")，这会让服务只接受本地回环请求，容器外部无法访问 -
EXPOSE 8080只是声明，必须配合docker run -p 8080:8080才真正映射 - 若用
docker-compose，检查ports字段是否漏写或格式错误（如写成"8080"而非"8080:8080"）
Dockerfile 必须用多阶段构建，否则镜像超大还带安全隐患
用 golang:alpine 直接 go run main.go 构建的镜像，体积动辄 800MB+，且含完整编译工具链和 root 权限，完全不适合生产。
- 第一阶段用
golang:1.21-alpine AS builder编译，加CGO_ENABLED=0 GOOS=linux确保静态链接 - 第二阶段用
alpine:3.18或scratch（如果确认无 cgo 依赖），只 COPY 二进制和必要配置（如configs/） - 务必加
USER appuser创建非 root 用户运行，避免容器逃逸风险 - 编译参数推荐：
go build -ldflags="-w -s" -a -installsuffix cgo -o gin-app .，剥离调试符号，减小体积
配置文件怎么进容器？别打包进二进制，也别硬编码路径
很多项目把 config.yaml COPY 进镜像，结果换环境就得重打镜像 —— 违反 12-Factor 原则。
立即学习“go语言免费学习笔记（深入）”；
- 配置应通过环境变量或挂载卷注入：
docker run -v $(pwd)/config-prod.yaml:/app/config.yaml ... - 代码里用
viper自动加载：viper.SetConfigFile("/app/config.yaml")，同时保留viper.AutomaticEnv()支持环境变量覆盖 - 路径统一用绝对路径（如
/app/config.yaml），避免因WORKDIR变化导致读取失败 - 启动前加校验逻辑：读不到配置就
log.Fatal("missing config")，别让容器静默失败
livenessProbe 和 readinessProbe 怎么写才不拖垮 Kubernetes？
Gin 默认没健康检查接口，K8s 的 probe 会不断失败，触发反复重启。
- 加一个简单路由：
r.GET("/healthz", func(c *gin.Context) { c.String(200, "ok") }) - K8s YAML 中 probe 设置建议：
initialDelaySeconds: 5、periodSeconds: 10、timeoutSeconds: 3 - 不要用
/做 readiness，它可能依赖 DB 或 Redis，冷启动时必然失败；专设/readyz并在代码里检查下游依赖连通性 - probe 请求走 HTTP，别用 HTTPS（除非明确配了证书），否则
curl -k不安全，http.Get更可控
gin.ReleaseMode 必须在容器启动前生效。靠 os.Setenv("GIN_MODE", "release") 不可靠，优先用 gin.SetMode(gin.ReleaseMode) 显式设置 —— 否则日志刷屏、中间件开销翻倍，压测时 QPS 直接腰斩。 
