直接用官方Go镜像构建Echo应用会出错，因镜像仅含编译环境而无运行时依赖，且未设置工作目录、暴露端口、处理信号；Echo不自带静态文件服务，监听地址若为127.0.0.1:8080则容器内不可达，需改为0.0.0.0:8080，并通过多阶段构建（builder+alpine运行）精简镜像、显式启用ca-certificates和CGO_ENABLED=0。
为什么直接用官方Go镜像构建Echo应用会出错
因为默认的 golang:alpine 或 golang:latest 镜像只含编译环境，没打包运行时依赖，且 Echo 本身不自带 HTTP 服务静态文件能力——你 go run main.go 能跑，但 Docker 里没指定工作目录、没暴露端口、没处理信号，容器一启动就退出。
常见错误现象：docker logs 看不到输出，docker ps 里看不到容器，或报 address already in use（端口被占）、exec: "app": executable file not found（没编译或路径错）。
- 确保
main.go中监听地址是0.0.0.0:8080，不是127.0.0.1:8080 - 构建前先本地
go build -o app .成功，再进 Docker 流程 - Alpine 镜像下若用了 cgo（如 SQLite、某些 DNS 解析），需加
CGO_ENABLED=0或换golang:slim
Dockerfile 多阶段构建的关键写法
必须用多阶段：第一阶段编译，第二阶段仅运行。否则镜像里塞满 go、git、/usr/local/go，体积翻 5 倍以上，还带安全风险。
典型正确结构：
立即学习“go语言免费学习笔记（深入）”；
FROM golang:1.22-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/app . EXPOSE 8080 CMD ["./app"]
-
CGO_ENABLED=0是 Alpine 下最稳的选择；若必须开 cgo，第二阶段得用gcr.io/distroless/static或alpine:edge并装对应库 -
EXPOSE不是必须，但写上能提醒自己端口约定，配合docker run -p 8080:8080更直观 - 别在第二阶段用
FROM scratch—— 缺少证书会导致 HTTPS 请求（如调第三方 API）失败，ca-certificates得显式装
如何让 Echo 应用响应 Docker 的健康检查
默认 Echo 没内置 /health 路由，Kubernetes 或 docker compose up --wait 会一直等超时。不能靠 curl http://localhost:8080 这种外部探测——容器内没 curl，且健康检查要轻量、无副作用。
- 在
main.go里加一条路由：e.GET("/health", func(c echo.Context) error { return c.String(http.StatusOK, "ok") }) - Dockerfile 后追加：
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD wget --quiet --tries=1 --spider http://localhost:8080/health || exit 1 - 避免用
curl：Alpine 默认没装，加apk add curl会增大镜像；wget更轻量，且 Alpine 自带
构建和验证命令别漏掉这三步
光 docker build -t my-echo-app . 不够，容易上线才发现问题。
- 构建后立刻跑一次：
docker run --rm -p 8080:8080 my-echo-app，另起终端curl http://localhost:8080/health看是否返回ok - 检查镜像大小：
docker images my-echo-app，正常应 ≤ 15MB（Alpine + 二进制）；若 > 50MB，大概率没用多阶段或误 COPY 了整个$GOPATH - 用
docker exec -it <container-id> ls -l进去确认只有app文件，没有go.mod、main.go等源码残留
健康路由、证书、CGO、端口绑定——这四点漏一个，Docker 里 Echo 就算编译过去也大概率起不来。
