平台不符的两种表现
no matching manifest for linux/amd64 或运行期 exec format error，都指向镜像与宿主平台不符。多架构标签能让拉取自动选择匹配架构，一旦显式指定平台，执行侧也必须具备对应的支持（例如跨架构模拟）。
基本信息
| 诊断 | uname -m 对照镜像的 Architecture 字段 |
|---|---|
| 指定拉取 | docker pull --platform linux/arm64 … |
| 运行 | 跨架构执行需要运行侧具备对应能力 |
| 多架构 | 清单让拉取自动选择平台 |
| 典型场景 | 开发机与服务器架构不同 |
典型使用场景
- 部署时报 no matching manifest，确认镜像是否提供目标架构
- 开发机与服务器架构不同导致容器无法启动
- 构建流水线需要产出多架构制品时的规划
- 验证跨架构模拟是否可用，判断能否临时运行
- 选型阶段核对基础镜像的架构支持范围
核对与指定平台
核对与指定平台
uname -m # 宿主架构
docker image inspect nginx:alpine -f '{{.Os}}/{{.Architecture}}' # 镜像平台
docker pull --platform linux/amd64 nginx:alpine
docker run --rm --platform linux/amd64 nginx:alpine uname -m现象与处理方向
| 现象 | 含义 | 处理方向 |
|---|---|---|
| no matching manifest | 清单里没有目标平台 | 确认镜像架构支持范围 |
| exec format error | 架构不符或二进制不匹配 | 改用匹配架构的镜像 |
| 拉取成功但启动失败 | 运行侧缺少对应支持 | 补齐能力或换节点 |
| 多架构标签正常 | 自动选择匹配平台 | 通常无需干预 |
面向两类架构发布时，用 buildx 多平台构建产出清单，运行侧由宿主自动选择，比手工指定平台更稳。
在 arm 开发机上本地构建的镜像默认是 arm64，推到 amd64 服务器直接起不来，构建侧要显式指定平台。
跨架构运行有性能折扣与兼容边界，适合验证不适合长期承载业务。
排查时先用 uname -m 与镜像平台字段对照，避免在不匹配的基础上继续查应用。
基础镜像的架构支持范围各不相同，选型阶段就要核对，别等部署时才发现没有对应清单。
集群里节点架构不一致时，同一份部署可能只在一部分节点上成功，排查时要按节点逐个核对架构，而不是只看整体报错。