Mac M1与Linux x86环境下Docker运行Go应用遇exec format error求助

核心问题分析 #

1. 可执行文件被覆盖：你的Dockerfile中，COPY ${APPPATH}/.env /docker-api_gateway这行命令把.env文件直接复制到了Go编译输出的可执行文件路径，导致最终容器内的/docker-api_gateway是文本文件而非二进制可执行程序，这是触发exec format error的直接原因。
2. 跨平台编译参数不匹配：目标环境是AWS ECS Linux x86_64（linux/amd64架构），但你未正确配置交叉编译参数，或Docker构建的平台设置与编译逻辑不匹配。

修正方案 #

1. 修复Dockerfile #

调整.env文件的复制路径，同时添加适配目标架构的交叉编译参数：

# syntax=docker/dockerfile:1

## Build
FROM golang:1.16-buster AS build

LABEL Author="Adam Gantt (adam@adamgantt.com)"

ENV APPPATH=api/src
WORKDIR /app

# 复制依赖清单并下载依赖
COPY ${APPPATH}/go.mod ./
COPY ${APPPATH}/go.sum ./
RUN go mod download

# 复制源代码文件
COPY ${APPPATH}/*.go ./

# 针对Linux x86_64架构交叉编译，禁用CGO以适配distroless镜像
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /docker-api_gateway

# 正确复制.env文件到单独路径，避免覆盖可执行文件
COPY ${APPPATH}/.env /app/.env

## Deploy
FROM gcr.io/distroless/base-debian10

WORKDIR /

# 复制编译好的可执行文件和.env文件
COPY --from=build /docker-api_gateway /docker-api_gateway
COPY --from=build /app/.env /.env

EXPOSE 9001

USER nonroot:nonroot

ENTRYPOINT ["/docker-api_gateway"]

2. 适配不同环境的构建与运行命令 #

Mac M1（arm64）环境

构建适配AWS的x86_64镜像：

docker build --platform linux/amd64 -t crm-plus-api-gateway:latest -f ./api/Dockerfile .

本地测试运行（需QEMU模拟x86_64架构）：

docker run --platform linux/amd64 -p 9001:9001 crm-plus-api-gateway:latest

Windows（x86_64）环境

直接使用常规命令构建与运行：

docker build -t crm-plus-api-gateway:latest -f ./api/Dockerfile .
docker run -p 9001:9001 crm-plus-api-gateway:latest

关键注意事项 #

• 保持CGO_ENABLED=0：distroless镜像缺少CGO依赖库，静态编译的Go程序才能正常运行。
• 严格区分文件路径：禁止将非可执行文件复制到编译输出的二进制路径。
• 平台参数统一：Mac M1环境下，构建时指定了--platform linux/amd64，运行时也需对应指定，否则会因架构不匹配报错。

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