多阶段构建可将iris服务镜像从300mb压缩至10–15mb，解决体积大、ca证书缺失、sigterm未处理导致k8s探针失败等问题。关键步骤：构建阶段用golang:1.23-alpine+cgo_enabled=0+静态链接；运行阶段用alpine:latest+ca-certificates+仅复制二进制；并显式实现/readyz探针、sigterm优雅关闭及外部配置注入。
直接用 FROM golang:alpine 跑 Iris 二进制，镜像体积大、有安全风险，且容易因缺少证书或信号处理导致 K8s 探针失败或 Pod 意外重启——这不是 Iris 的问题，是 Dockerfile 写法没对齐容器运行时契约。
为什么不能直接用 golang 镜像做 runtime
很多初学者把本地编译好的 iris-app 直接 COPY 进 golang:alpine 镜像里跑，结果在 K8s 里频繁 CrashLoopBackOff。根本原因是：
-
golang:alpine包含整个 Go 工具链（go、gcc、pkg等），体积超 300MB，攻击面大 - Alpine 默认不带 CA 证书，
http.Client访问 HTTPS 服务（如 Redis TLS、外部 API）会报x509: certificate signed by unknown authority - 没显式处理
SIGTERM，K8s 发送终止信号后进程立刻退出，正在处理的请求被粗暴中断
必须用多阶段构建 + alpine 运行时
目标：最终镜像只含可执行文件、CA 证书、必要依赖，体积控制在 10–15MB 以内。关键步骤：
- 构建阶段用
golang:1.23-alpine（确保 Go 版本与项目一致），禁用 CGO：CGO_ENABLED=0 - 加静态链接参数：
-ldflags '-extldflags "-static"'，避免运行时缺 libc - 运行阶段用
alpine:latest，必须RUN apk --no-cache add ca-certificates -
COPY --from=builder只复制二进制，不带源码、mod 文件、测试文件 - 显式声明
EXPOSE 8080（虽不生效于网络，但防止 CI/CD 工具告警）
示例 Dockerfile：
FROM golang:1.23-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o iris-app . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/iris-app . EXPOSE 8080 CMD ["./iris-app"]
启动前必须检查的三件事
Iris 启动快不代表 ready，K8s 的 readinessProbe 很可能在 DB 连不上时就把 Pod 干掉。要让容器真正“可交付”，得主动控制就绪状态：
- 禁用默认 panic recovery：
app.UseRouter = false或重写iris.Configuration().FireMethodNotExists = false，否则初始化错误会被吞掉，探针永远收不到 200 - 手动暴露
/readyz端点，里面调db.Ping()、redis.Ping()等依赖健康检查，任一失败就返回 503 - 监听
SIGTERM并调用app.Shutdown()，别依赖os.Exit(0)—— 否则livenessProbe会误判为存活，但新请求已进不来
环境变量和配置注入别硬编码
镜像一旦构建完成，就该是不可变的。所有可变参数必须通过外部注入：
- 端口用
iris.Listen(os.Getenv("PORT"))，别写死:8080 - 数据库地址、Redis 地址全部走
os.Getenv()，不要在config.go里写"localhost:6379" - K8s 中用
ConfigMap或Secret挂载，Docker Compose 用env_file或environment字段 - 如果用了 Iris 的
iris.Configurator，确保LoadFrom指向的是/config/app.yaml这类挂载路径，而非当前目录
最常被忽略的一点：Iris 的 Shutdown() 默认等待 30 秒，但 K8s 的 terminationGracePeriodSeconds 默认只有 30 秒——如果请求处理时间接近这个值，就会被强制 kill。务必在 Deployment 中显式设为 60，并在代码里匹配这个 timeout。
