如何构建可兼容M1 Mac等多平台的Java Spring Boot Docker镜像？

你当前使用的openjdk:13-jdk-alpine官方基础镜像仅提供x86_64架构版本，M1 MacBook Pro的CPU为ARM64架构，Docker默认通过QEMU转译运行x86架构镜像时，JVM会出现底层指令兼容问题，就是你遇到的基础Java符号找不到、JVM异常类报错。

可以通过Docker buildx构建同时支持x86_64、ARM64架构的多平台镜像，具体操作如下：

1. 替换兼容多架构的JDK基础镜像 #

openjdk 13的alpine版本官方未提供ARM64构建，有两种可选方案：

• 推荐升级到长期支持版本的JDK，例如openjdk:17-jdk-alpine，官方同时维护x86_64和ARM64架构的镜像，兼容性最好
• 若必须使用Java 13，可更换为openjdk:13-jdk（非alpine版本，官方有ARM64构建），或使用第三方维护的支持ARM64的openjdk13 alpine镜像

2. 启用Docker多架构构建能力 #

确保Docker版本≥20.10，执行命令创建多架构构建器：

docker buildx create --name multiarch-builder --use
docker buildx inspect --bootstrap

第二行命令执行完成后输出中包含Platforms: linux/amd64, linux/arm64即代表配置成功。

3. 执行多架构镜像构建 #

如果需要将构建后的镜像推送到镜像仓库，执行以下命令：

docker buildx build --platform linux/amd64,linux/arm64 -t <你的镜像地址>:<镜像标签> . --push

如果仅需要本地测试使用，可单独构建对应架构的镜像加载到本地：

# 构建x86架构镜像加载到本地
docker buildx build --platform linux/amd64 -t <镜像名>:<标签> . --load
# 构建ARM64架构镜像加载到本地
docker buildx build --platform linux/arm64 -t <镜像名>:<标签> . --load

4. 验证镜像架构 #

构建完成后可执行命令查看镜像支持的架构列表：

docker buildx imagetools inspect <你的镜像地址>:<镜像标签>

输出中同时包含linux/amd64和linux/arm64条目即代表多架构镜像构建成功。

• 若Dockerfile中存在手动下载二进制依赖的步骤，需确保依赖包同时提供x86_64和ARM64版本，不要写死下载x86专属的二进制文件
• 临时在M1上运行x86架构镜像可在docker run命令中添加--platform linux/amd64参数强制转译运行，但性能损耗较大，仅适合临时调试使用

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