首页/云/Docker 容器速查/exec format error 定位
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

exec format error 定位

exec format error:可执行文件与宿主 CPU 架构不符、脚本没有 shebang、或二进制被截断;先看架构再看文件格式。

Docker 容器速查云更新于 2026-10-12
高频场景arm64 镜像在 amd64 宿主(或反向)执行
验证uname -m 与镜像 Architecture 对照
处置改用匹配架构标签或安装 binfmt/qemu 支持

示例

示例
uname -m
docker image inspect nginx:alpine -f '{{.Os}}/{{.Architecture}}'
head -1 entrypoint.sh
docker run --rm --platform linux/arm64 alpine uname -m
多架构清单让 pull 自动选平台;一旦使用 --platform 覆盖,执行侧也要有对应模拟支持。

易错点

  • 本地 Mac(arm)构建的镜像拿到 amd64 服务器直接 exec format error,构建侧要指定平台
  • shebang 缺失的脚本被当二进制执行同样报此错,head -1 一步验证

数据来源与参考

  • Docker 官方文档:Multi-platform images(docs.docker.com/build)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌