在Golang Docker容器中执行go run命令时出现$PATH找不到可执行文件错误

问题原因 #

报错exec: 'go': executable file not found in $PATH的核心原因是容器运行环境中没有Go工具链，常见场景有两种：

• 采用多阶段构建时，最终运行阶段基于纯alpine镜像（不含Go环境），仅复制了编译好的主程序，未保留Go工具链；
• 即便使用golang:1.21.7-alpine3.19作为运行镜像，也可能在构建过程中通过自定义脚本删除了Go工具链（默认该镜像自带完整Go环境）。

解决方案 #

方案1：直接在builder镜像中运行（仅调试用） #

如果只是临时调试，确保容器基于golang:1.21.7-alpine3.19镜像启动，该镜像默认包含完整Go工具链：

docker run -it --rm -v $(pwd):/app docker.io/golang:1.21.7-alpine3.19 /bin/sh

进入容器后执行go version确认环境正常，再运行你的程序即可。

方案2：预编译二进制文件（生产环境推荐） #

生产环境禁止使用go run（依赖Go环境、运行效率低），正确做法是提前编译anotherProgram.go为二进制文件：

1. 修改Dockerfile，在builder阶段完成编译：

FROM docker.io/golang:1.21.7-alpine3.19 AS builder

WORKDIR /app
COPY . .

# 编译anotherProgram为二进制可执行文件
RUN go build -o anotherProgram anotherProgram.go

# 最终运行阶段用轻量alpine镜像
FROM alpine:3.19

# 复制编译好的二进制文件到运行镜像
COPY --from=builder /app/anotherProgram /usr/local/bin/
# 同时复制你的主程序（如果主程序也需要编译）
COPY --from=builder /app/your-main-program /usr/local/bin/

CMD ["/usr/local/bin/your-main-program"]

2. 修改主程序中的执行代码，直接调用二进制文件：

cmd := exec.Command("/usr/local/bin/anotherProgram", param1, param2)

方案3：在运行镜像中安装Go工具链（不推荐） #

如果必须在运行时使用go run，可以在运行阶段的镜像中安装Go（会大幅增加镜像体积）：

FROM alpine:3.19

# 安装指定版本的Go工具链
RUN apk add --no-cache go=1.21.7-r0

WORKDIR /app
COPY . .

CMD ["/usr/local/bin/your-main-program"]

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