Docker容器启动报错exec /main找不到文件（文件实际存在）求助

出现exec /main: no such file or directory但文件实际存在的核心原因是：Go默认编译的可执行文件依赖glibc，而Alpine镜像使用的是musl libc，动态链接器不兼容，系统找不到对应的动态链接库，才抛出这个看似矛盾的错误。

解决方案 #

方案1：静态编译Go程序（推荐） #

编译时禁用CGO，强制生成不依赖系统libc的静态可执行文件：

CGO_ENABLED=0 GOOS=linux go build -o main cmd/*.go

重新构建镜像并运行即可，静态编译的程序在Alpine这类轻量镜像中可以直接运行，没有依赖问题。

方案2：切换到基于glibc的基础镜像 #

如果必须使用动态编译的程序，将Dockerfile的基础镜像换成Debian/Ubuntu这类使用glibc的发行版：

FROM debian:bookworm-slim
COPY main .
COPY configs/. .
EXPOSE 8081
CMD ["/main"]

验证方法 #

可以先在本地检查编译出的main文件的链接类型，确认是否为静态编译：

file main

如果输出包含statically linked说明是静态编译，符合Alpine的运行要求；如果是dynamically linked则依赖系统libc，需要调整编译方式或镜像。

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