Docker容器启动失败：无法找到/app/server文件的排查求助

针对你遇到的stat /app/server: no such file or directory错误，结合你的Dockerfile和构建日志，以下是具体排查方向和解决方法：

1. 确认编译产物是否真的生成并复制到最终镜像 #

构建日志显示go build步骤执行成功，但可以额外验证：

• 临时修改Dockerfile，在go-builder阶段的RUN go build后添加：

  RUN ls -l /app/server
  

  重新构建，查看是否输出文件信息，确认二进制存在。
• 或者直接运行builder镜像查看内容：

  # 先构建并获取go-builder阶段的临时镜像ID，再查看文件
  docker run --rm $(docker build --target go-builder -q .) ls -l /app
  

• 也可以在最终的alpine阶段添加RUN ls -l /app，确认文件是否被正确复制。

2. 解决Go二进制动态链接依赖问题（最常见原因） #

Alpine使用musl libc，而Go默认编译的二进制如果开启了CGO，会依赖glibc，导致在Alpine中无法执行，系统会误报为“文件不存在”。

修改go-builder阶段的编译命令，强制静态编译：

RUN CGO_ENABLED=0 go build -buildvcs=false -v -o server

3. 检查Docker Compose是否指定了正确的构建阶段 #

如果你的docker-compose.yml中配置了build.target: development，那么启动的是带reflex的开发镜像，该镜像中不存在/app/server文件，自然会报错。

确认compose配置中没有指定错误的target，默认会使用Dockerfile的最后一个阶段（即alpine生产阶段）：

services:
  your-service:
    build:
      context: .
      # 确保未指定target为development，无需额外配置即可使用最终生产镜像

4. 验证二进制的可执行权限 #

虽然构建时默认会保留执行权限，但可以在最终镜像中手动添加权限确认步骤：

FROM alpine:latest
COPY --from=go-builder /app/server /app/server
RUN chmod +x /app/server
CMD ["/app/server"]

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