M1 Mac本地运行SpringBoot3 GraalVM原生Docker容器失败

我基于SpringBoot3和GraalVM运行时构建了一个简单的REST API，尝试将其Docker化并在M1 Mac本地运行，但启动容器时出现「exec /app: exec format error」错误。

我的Dockerfile内容：

#FROM container-registry.oracle.com/os/oraclelinux:8-slim
#FROM scratch
FROM gcr.io/distroless/base

EXPOSE 8080
COPY build/native/nativeCompile/nativeimage app
ENTRYPOINT ["/app"]

镜像检查信息显示：

"Architecture": "arm64",
"Os": "linux",

我可以直接运行原生可执行文件，但希望能通过Docker容器运行，且因使用Gradle构建，不知如何在容器内构建原生镜像。

一、修复「exec /app: exec format error」错误 #

这个错误核心是本地构建的原生可执行文件和容器的系统/架构不匹配——你在M1 Mac（arm64）上直接构建的可执行文件是针对macOS的，无法在Linux容器中运行，哪怕镜像架构是arm64也不行。

修复步骤：

• 指定Gradle构建Linux兼容的arm64可执行文件
  在终端执行：

  ./gradlew nativeCompile -Porg.graalvm.nativeimage.platform=linux-aarch64
  

  该参数会让GraalVM生成适配Linux arm64架构的可执行文件，而非macOS版本。
• 验证文件类型
  用file命令确认构建结果：

  file build/native/nativeCompile/nativeimage
  

  输出需包含ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV)，确保是Linux arm64格式。
• 重新构建镜像并运行
  保持原Dockerfile不变，执行：

  docker build -t spring-native-api .
  docker run -p 8080:8080 spring-native-api
  

二、在容器内构建原生镜像（Gradle方式） #

如果想彻底避免本地与容器的环境差异，可使用多阶段构建的Dockerfile，全程在容器内完成构建：

# 第一阶段：用GraalVM官方镜像构建原生可执行文件
FROM ghcr.io/graalvm/graalvm-ce:latest AS builder

# 安装构建依赖
RUN microdnf install -y gcc glibc-devel zlib-devel

WORKDIR /app

# 复制Gradle配置和源码
COPY build.gradle settings.gradle ./
COPY src ./src

# 构建适配Linux arm64的原生镜像
RUN ./gradlew nativeCompile -Porg.graalvm.nativeimage.platform=linux-aarch64

# 第二阶段：用轻量镜像运行
FROM gcr.io/distroless/base

EXPOSE 8080

# 从构建阶段复制可执行文件
COPY --from=builder /app/build/native/nativeCompile/nativeimage /app

ENTRYPOINT ["/app"]

构建并运行：

docker build -t spring-native-api .
docker run -p 8080:8080 spring-native-api

这种方式能确保构建出的可执行文件与运行容器的环境完全匹配，同时最终镜像保持轻量。

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