docker多架构构建的关键在于选用已发布多平台变体的基础镜像，并通过docker buildx build --platform显式声明目标架构，from指令本身不自动适配架构。
FROM 指令本身不支持“自动适配多架构”，它的作用是拉取指定标签的基础镜像。真正实现多架构适配的关键在于：**你选用的 base image 必须已发布对应平台的官方变体，且构建时通过 docker buildx build --platform 显式声明目标架构**。Docker 会根据 --platform 参数，自动匹配并拉取该平台下同标签的镜像（如 eclipse-temurin:21-jre-alpine 在 ARM64 主机上拉 arm64 版，在 x86_64 主机上拉 amd64 版）。
选对本身就支持多平台的基础镜像
这是前提。如果基础镜像没为 ARM64、LoongArch64 等架构单独构建并推送到 Registry，FROM 就无从选择。
- eclipse-temurin:21-jre-alpine：官方明确提供 linux/amd64、linux/arm64、linux/loong64、linux/ppc64le 等全平台镜像，Alpine 小体积 + musl libc 兼容性好，推荐首选
- azul-zulu:21-jre：Azul 为龙芯 LoongArch64 单独发布构建版本，信创环境（如 3A5000）部署优先考虑
- amazoncorretto:21-jre-alpine：AWS 长期维护，ARM64 支持稳定，适合天翼云鲲鹏集群等国产云场景
- 避免使用
oraclelinux:8-jdk或老旧openjdk:17：它们未同步更新 ARM/LoongArch 构建，拉取可能失败或降级到 QEMU 模拟层，性能差且不可靠
Dockerfile 中 FROM 写法要保持中立
不能写任何与具体架构绑定的指令，否则会破坏跨平台一致性。
- ✅ 正确：
FROM eclipse-temurin:21-jre-alpine—— 标签通用，由 buildx 根据 --platform 自动解析对应架构镜像 - ❌ 错误：
RUN apt-get install -y openjdk-21-jdk:arm64—— 硬编码架构，x86 构建时会失败 - ❌ 错误：
RUN dpkg --add-architecture arm64—— Debian/Ubuntu 特有指令，不适用于 Alpine，也不适用于其他平台 - 若需 jlink 裁剪 JDK，确保所用基础镜像（如 Temurin Alpine）已预装对应平台的 jlink 工具，无需额外安装
构建时必须指定目标平台
仅靠 FROM 无法触发多架构行为；buildx 的 --platform 才是“开关”。
- 命令示例：
docker buildx build --platform linux/amd64,linux/arm64,linux/loong64 --push -t myapp:latest . - Buildx 会并发拉取三个平台各自的
eclipse-temurin:21-jre-alpine镜像（比如@sha256:abc...对应 amd64，@sha256:def...对应 arm64），分别执行构建步骤 - 最终生成一个 manifest list（镜像索引），把三个平台镜像的 digest 聚合在一起推送到 Registry
- 用户执行
docker pull myapp:latest时，Docker 客户端自动读取 manifest list，并下载与本机 platform 匹配的那个镜像
