必须显式设置CGO_ENABLED=0和GOOS=linux，否则二进制非静态，导致在scratch或最小化alpine镜像中启动报“no such file or directory”；需配合GOARCH、-ldflags="-s -w"及多阶段构建优化体积与安全性。
CGO_ENABLED=0 和 GOOS=linux 必须显式设置，否则二进制不是静态的
很多人以为用了 alpine 就是轻量运行环境，结果镜像跑起来报 no such file or directory——根本原因是没关 CGO。Go 默认启用 CGO，哪怕你只用 net/http 或 echo/v4，也会隐式链接系统 libc。在 golang:alpine 里编译看似能跑，但换到 scratch 或某些最小化 alpine 镜像就崩。
必须在构建阶段显式加：
-
CGO_ENABLED=0：禁用 C 调用，生成纯静态二进制 -
GOOS=linux：避免在 macOS/Windows 上构建出darwin或windows二进制 -
GOARCH=amd64（可选）：明确架构，避免跨平台混淆 -
go build -a -ldflags '-s -w'：-a强制重编所有依赖，-s -w去掉符号表和调试信息，体积减少 30%~50%
错误写法：RUN go build -o main . —— 没设环境变量，等于白搭多阶段。
COPY 顺序决定缓存效率，go.mod 必须先于源码复制
Docker 构建缓存对 Go 项目特别敏感。如果直接 COPY . .，每次改一行 main.go 都会失效整个 go mod download 层，构建时间翻倍。
立即学习“go语言免费学习笔记（深入）”；
正确顺序是：
-
COPY go.mod go.sum ./：先复制依赖声明文件 -
RUN go mod download：下载并缓存模块，只要这两个文件不变，这层永远命中 -
COPY cmd/ ./或COPY main.go ./：只复制入口文件，避免拖入testdata/、.git/、node_modules/
别忘了配 .dockerignore，至少排除：.git、README.md、docs/、vendor/（除非你真用 vendor）。
运行阶段别用 golang:alpine，用 alpine:latest 或 scratch
golang:alpine 是构建镜像，不是运行镜像。它带编译器、git、apk、shell……你的 Echo 服务只需要一个二进制 + ca-certificates（HTTPS 必需）。
推荐组合：
- 用
alpine:latest：加RUN apk --no-cache add ca-certificates，适合需要 HTTPS 调用第三方 API 或数据库 TLS 连接的场景 - 用
scratch：极致精简，但必须确保二进制完全静态（CGO_ENABLED=0成功）、不依赖任何系统库、且不需证书（或自己 COPY 进去）
别写 FROM golang:alpine 在第二阶段——那只是把构建环境又搬了一遍，镜像仍 >700MB。
echo/v4 的日志和错误处理在容器里要适配 stdout
Echo 默认用 e.Logger 打印启动日志，但在容器里如果没配置，可能卡住或输出乱码。尤其 e.Logger.Fatal(e.Start(":8080")) 这种写法，在 Docker 中遇到 SIGTERM 时不会优雅退出。
建议调整：
- 用
log.SetOutput(os.Stdout)统一日志输出目标 - 监听
os.Interrupt和syscall.SIGTERM实现 graceful shutdown - 避免在
main()末尾写select{}等死，Echo 启动后应交由信号控制生命周期
容器里没有终端交互能力，所有日志必须走 stdout/stderr，否则 docker logs 看不到关键信息。
最易被忽略的是：即使写了多阶段，如果构建阶段没设 CGO_ENABLED=0 和 GOOS=linux，最终二进制仍是动态链接的——你只是把臃肿的构建过程从本地挪进了容器，没解决本质问题。
