go build 在 Docker 中失败主因是构建上下文未正确包含 go.mod 或 WORKDIR 设置错误；多阶段构建可减小镜像体积；容器默认 UTC 时区需手动配置；go test 需确保失败中断构建流程。
为什么 go build 在 Docker 容器里编译失败？
常见现象是 go: cannot find main module 或 go: go.mod file not found，根本原因是构建上下文没把 go.mod 和源码一起 COPY 进去，或 WORKDIR 设错导致 Go 工具链找不到模块根目录。
- 确保
Dockerfile中COPY . .前已执行go mod init，且go.mod和main.go在同一层级 -
WORKDIR必须设为模块根目录（即含go.mod的路径），不能是/app后再COPY—— 那样 Go 会认为当前无 module - 多模块项目慎用
COPY . .，优先COPY go.mod go.sum ./→RUN go mod download→COPY *.go ./，避免缓存失效
如何用多阶段构建减小最终镜像体积？
Golang 编译产物是静态二进制，不需要 Go 环境运行，但很多人直接用 golang:alpine 构建+运行，结果镜像仍带完整 Go 工具链和构建依赖，白白多出 300MB+。
- 第一阶段用
golang:1.22-alpine编译：RUN CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o /app/myapp . - 第二阶段用
scratch或alpine:latest：只COPY --from=0 /app/myapp /usr/local/bin/myapp - 若需调试或日志工具，选
alpine；若极致精简且确定无 libc 依赖（CGO_ENABLED=0时满足），用scratch
为什么容器里 time.Now() 返回 UTC 而不是本地时区？
Docker 默认不挂载宿主机时区文件，time.Now() 在容器中 fallback 到 UTC。这不是 Go 的 bug，而是 Linux 容器的默认行为。
- 在
FROM镜像不含/usr/share/zoneinfo时（如scratch），必须显式挂载或复制时区数据：COPY /usr/share/zoneinfo/Asia/Shanghai /usr/share/zoneinfo/Asia/Shanghai - 设置环境变量：
ENV TZ=Asia/Shanghai，并确保 Go 程序调用time.LoadLocation("Asia/Shanghai")而非依赖time.Local - 更稳妥做法：启动容器时用
-v /etc/localtime:/etc/localtime:ro，但 CI/CD 构建阶段无法挂载，所以构建时复制仍是必要手段
如何让 go test 在 Docker 构建中真正生效？
很多 Dockerfile 写了 RUN go test -v ./...，但测试失败时构建却继续 —— 因为没加 set -e 或没检查返回值。
立即学习“go语言免费学习笔记（深入）”；
- Go 测试失败时 exit code 非 0，但 Docker 的
RUN默认不中断流程，除非该命令本身失败。确认你没用|| true或bash -c "go test || echo ignore"这类掩盖错误的写法 - 推荐写法：
RUN CGO_ENABLED=0 go test -race -v -timeout 30s ./...（-race对容器内并发测试很重要） - 若测试依赖外部服务（如 DB），不要在构建阶段跑集成测试；拆分为构建后
docker run --network单独验证，否则构建不可重现
最易被忽略的是模块路径与 WORKDIR 的耦合关系——哪怕只差一个 ./cmd，go build 就可能静默编译出错包，而镜像还能跑起来（因为用了旧缓存）。务必每次改完 go.mod 后清理构建缓存验证一次。
