M1芯片Mac构建Go Docker镜像在Linux服务器启动报错求助

问题本质 #

你遇到的exec format error是因为容器内执行的二进制文件架构和Linux服务器的amd64架构不匹配。虽然指定了--platform=linux/amd64，但Go编译阶段未正确做交叉编译，导致生成的二进制仍是M1 Mac的arm64架构，或者最终镜像误包含了arm64版本的Go程序。

修复步骤 #

1. 修正Dockerfile（多阶段构建+强制交叉编译） #

用多阶段构建分离编译和运行环境，确保生成linux/amd64架构的二进制，且最终镜像只保留编译好的程序（无需携带Go环境）：

# Build阶段：指定amd64架构的Go官方镜像
FROM --platform=linux/amd64 golang:1.22-alpine AS builder

WORKDIR /app
# 复制依赖清单并下载依赖
COPY go.mod go.sum ./
RUN go mod download

# 复制代码并交叉编译
COPY . .
# 明确指定目标平台，禁用CGO避免依赖系统库
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o myapp ./main.go

# 最终镜像：使用轻量的amd64 alpine镜像
FROM --platform=linux/amd64 alpine:latest

WORKDIR /app
# 从build阶段复制编译好的二进制文件
COPY --from=builder /app/myapp .

# 启动程序
CMD ["./myapp"]

2. 构建与启动时强制指定平台 #

• 构建镜像命令：

  docker build --platform=linux/amd64 -t your-image:latest .
  

• docker-compose.yml配置：

  services:
    your-service:
      image: your-image:latest
      platform: linux/amd64
      # 其他业务配置...
  

核心注意点 #

• 不要用Go镜像作为最终运行镜像，否则会引入与架构不匹配的Go二进制文件，触发exec错误。
• 交叉编译时必须显式设置GOOS=linux和GOARCH=amd64，覆盖Go镜像默认的架构参数。

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