2. 使用多阶段构建优化 Go 应用镜像体积

为什么单阶段构建的 Go 镜像会很大

Go 是编译型语言，编译过程需要完整的 Go 工具链（约 800MB+），但编译产物是一个静态二进制文件，运行时并不需要这些工具。单阶段构建把编译环境和运行环境塞进同一个镜像，导致最终镜像包含大量无用文件。

多阶段构建的核心思路：用第一个阶段（builder）完成编译，用第二个阶段（runtime）只复制编译产物，丢弃整个工具链。

编写多阶段 Dockerfile

以下 Dockerfile 针对一个简单的 Go HTTP 服务，使用 golang:1.22-alpine 作为构建阶段，alpine:3.19 作为运行阶段。关键点：AS builder 命名阶段，COPY --from=builder 只复制二进制文件。

# ---- Stage 1: 编译 ----
FROM golang:1.22-alpine AS builder

WORKDIR /src

# 先复制依赖清单，利用缓存层
COPY go.mod go.sum ./
RUN go mod download

# 复制源码并编译
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /app/server .

# ---- Stage 2: 运行 ----
FROM alpine:3.19

# 安装 CA 证书（HTTPS 请求需要）
RUN apk add --no-cache ca-certificates

WORKDIR /app
COPY --from=builder /app/server .

EXPOSE 8080
CMD ["./server"]

构建与体积对比

准备一个最小 Go 应用用于验证：

// main.go
package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "Hello from multi-stage build!")
    })
    http.ListenAndServe(":8080", nil)
}

# 初始化模块
go mod init example.com/hello

# 构建多阶段镜像
docker build -t hello-go:multi .

# 查看镜像大小
docker images hello-go:multi

对比单阶段构建（使用 golang:1.22-alpine 直接作为最终镜像）与多阶段构建的体积差异：

验证运行正确性

构建完成后，启动容器并验证服务正常响应：

# 启动容器
docker run -d --name hello-test -p 8080:8080 hello-go:multi

# 验证 HTTP 响应
curl http://localhost:8080/
# 预期输出：Hello from multi-stage build!

# 检查容器状态
docker ps --filter name=hello-test

# 清理
docker stop hello-test && docker rm hello-test

如果 curl 返回预期文本且容器处于 Up 状态，说明多阶段构建产出的镜像功能完整。若容器启动后立即退出，常见原因是二进制缺少执行权限或动态链接库缺失——检查是否遗漏了 CGO_ENABLED=0。