Docker容器在Mac可正常运行但在Windows启动失败求助

兄弟，我之前碰到过一模一样的问题！这个报错看起来是找不到可执行文件，实际上大概率是Go编译的二进制和Windows Docker容器的架构/依赖库不兼容导致的，咱们来一步步解决：

问题根源分析 #

1. 架构不匹配：如果你用的是M系列Mac（ARM64架构），默认编译出来的二进制是ARM64版本，但Windows Docker Desktop默认可能跑的是x86_64（AMD64）架构的容器，Alpine识别不了ARM的二进制，就会报“找不到文件”。
2. CGO依赖冲突：Go默认会启用CGO，编译出来的二进制依赖系统的glibc库，但Alpine用的是轻量的musl libc，两者不兼容，也会导致二进制无法执行，表现同样是这个报错。

解决方案：修改Dockerfile的编译参数 #

只需要在go build命令前加上几个环境变量，强制编译出适配Linux Alpine且不依赖系统libc的静态二进制：

修改后的Dockerfile：

FROM golang:latest AS builder

WORKDIR /app

COPY ./ .

# 重点：添加CGO_ENABLED=0，指定目标OS和架构
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /app/hello

FROM alpine:latest

WORKDIR /app

COPY --from=builder /app/hello .

CMD ["/app/hello"]

参数解释：

• CGO_ENABLED=0：禁用CGO，让Go编译纯静态的二进制文件，完全不依赖系统的libc库，完美适配Alpine的musl环境。
• GOOS=linux：明确指定目标操作系统是Linux，毕竟容器里跑的是Alpine Linux。
• GOARCH=amd64：指定目标架构为x86_64，适配Windows Docker Desktop默认的架构（如果你是Windows ARM设备，把这个改成arm64就行）。

验证步骤 #

1. 删掉之前的镜像和容器：docker rm -f <容器名> && docker rmi <镜像名>
2. 重新构建镜像：docker build -t gin-server .
3. 启动容器：docker run -p 8080:8080 gin-server

这样应该就能在Windows上正常运行了！

附你提供的原始代码 #

main.go

package main

import (
	"github.com/gin-gonic/gin"
)

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run()
}

原始Dockerfile

FROM golang:latest AS builder

WORKDIR /app

COPY ./ .

RUN go build -o /app/hello

FROM alpine:latest

WORKDIR /app

COPY --from=builder /app/hello .

CMD ["/app/hello"]

备注：内容来源于stack exchange，提问作者chris