基于BusyBox构建Go Web服务镜像，运行容器时提示server未找到

问题根因 #

你的Go Web服务默认是动态编译的，而标准busybox:latest这类极简镜像用的是musl libc，缺少程序依赖的GNU C标准库（glibc）相关组件——哪怕文件确实存在，系统找不到对应的动态链接器或依赖库，照样会报“not found”。而简单的Hello World因为逻辑简洁，编译时自动静态链接了必要组件，所以能正常运行。

具体解决办法 #

1. 静态编译Go程序 #

修改编译命令，强制把所有依赖打包进可执行文件，摆脱对系统动态库的依赖：

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags '-w -s' server.go

参数说明：

• CGO_ENABLED=0：禁用CGO，强制静态编译（大部分Web服务无需CGO，若你的代码用到CGO需额外处理）
• -a：强制重新编译所有依赖，确保静态链接生效
• -ldflags '-w -s'：移除调试信息，缩小可执行文件体积

2. 验证编译结果 #

编译完成后用file命令确认是静态链接：

file server

输出包含statically linked即说明编译正确。

3. 调整Dockerfile（可选） #

确保Dockerfile正确复制文件并设置执行权限，同时使用exec格式的CMD：

FROM busybox:latest
WORKDIR /home
COPY server ./server
RUN chmod +x /home/server
CMD ["/home/server"]

用CMD ["..."]格式可避免调用/bin/sh，减少额外依赖问题。

4. 重新构建运行 #

重新打包镜像并启动容器：

docker build -t my-busybox-server .
docker run -p 8080:8080 my-busybox-server

备选方案（若必须使用CGO） #

如果你的代码离不开CGO，无法静态编译，可改用带glibc的BusyBox镜像，比如busybox:glibc：

FROM busybox:glibc
WORKDIR /home
COPY server ./server
CMD ["/home/server"]

这样动态编译的程序就能找到所需的依赖库了。

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