Docker多阶段构建问题：编译后的二进制文件无法执行

我之前也踩过类似的坑，咱们一步步拆解问题并解决：

问题根源分析 #

从你的测试现象来看，二进制明明存在却提示"找不到"，核心是两个关键问题：

1. 编译环境变量未正确传递到构建命令
   你Dockerfile里的CGO_ENABLED=0 GOOS=linux GOARCH=amd64是单独放在一个RUN命令中的，但Docker的每个RUN都是独立的shell会话，这个环境变量不会保留到后续的go build步骤里。
   这导致Go编译时可能仍启用了CGO，生成的二进制依赖GNU libc（glibc），而Alpine Linux用的是musl libc，二者不兼容，系统就会抛出"找不到可执行文件"的错误（本质是找不到依赖的库）。

2. CMD执行时的路径缺失问题
   你的WORK_DIR是/docker/bin，但这个目录不在容器默认的$PATH中，所以直接用CMD ["go_docker"]会因找不到命令路径报错，需要指定绝对路径或者把工作目录加入PATH。

修正后的Dockerfile #

FROM golang as goimage
ENV SRC=/go/src/
RUN mkdir -p /go/src/
WORKDIR /go/src/go_docker
# 合并命令减少镜像层数，同时确保编译环境变量生效
RUN git clone https://github.com/bryonbaker/simple-microservice.git /go/src/go_docker/ \
    && go get github.com/gorilla/mux \
    && CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o bin/go_docker

FROM alpine:latest AS microservice
RUN apk --no-cache add bash
ENV WORK_DIR=/docker/bin
WORKDIR $WORK_DIR
# 将工作目录加入PATH，方便直接调用二进制文件
ENV PATH="$WORK_DIR:$PATH"
COPY --from=goimage /go/src/go_docker/bin/ ./
ARG VERSION=1.0
RUN echo $VERSION > image_version
EXPOSE 10000
CMD ["go_docker"]

关键修改点说明 #

• 编译参数与build命令绑定：把CGO_ENABLED=0等参数直接前置在go build命令前，确保编译时使用静态编译模式，生成不依赖系统libc的独立二进制。
• 添加工作目录到PATH：通过ENV PATH="$WORK_DIR:$PATH"让容器能直接识别当前目录下的二进制，不用写冗长的绝对路径。
• 合并RUN命令：既减少了镜像层数，又保证环境变量在同一个shell会话中生效，避免跨命令的环境丢失问题。

验证方法 #

你可以在编译阶段确认二进制是否为静态编译：

# 临时启动goimage容器，检查二进制的链接状态
docker run --rm goimage ldd /go/src/go_docker/bin/go_docker

如果输出显示not a dynamic executable，说明是完全静态编译的，放到Alpine容器里就能正常运行了。

内容的提问来源于stack exchange，提问作者Bryon