Docker启动报格式错误:核对镜像架构

镜像能拉下来,不代表其中的程序一定能在当前服务器运行。容器启动就报exec format error,常见方向是程序架构不兼容或入口文件格式有问题;此时先改端口、防火墙和内存,通常不能解决启动失败。

下面针对Linux容器。使用原来管理该部署的Docker连接方式,myapp替换成失败的容器名。先保留旧容器、日志和部署配置,不要立即删除镜像再拉latest。

比较Docker服务端,别比较自己的电脑

docker info --format 'Server={{.OSType}}/{{.Architecture}}'
docker inspect --format 'Status={{.State.Status}} Error={{.State.Error}}' myapp
docker inspect --format 'ImageID={{.Image}} ImageRef={{.Config.Image}}' myapp

第一条读取实际连接的Docker daemon平台。使用远程context时,电脑上的uname -m不能代替这个结果。常见的x86_64对应镜像平台amd64,aarch64对应arm64;显示名称不同,不一定是不兼容。ARM的具体variant也应按发布方支持范围核对。

后两条保存实际启动错误、容器引用的镜像标识与镜像名。同一个标签可能后来指向新版本,仅查看“这个标签现在是什么架构”,不能证明失败容器当时用了什么。

确认容器实际使用了哪一个平台

较新且支持多平台镜像存储的Docker,可以检查容器选中的平台专属清单。若字段存在,重点看其中的platform及digest。容器外层的Platform只显示linux时,不能据此判断CPU架构:

docker inspect --format '{{json .ImageManifestDescriptor}}' myapp

旧版本或传统镜像存储可能没有该字段,输出为空或提示字段不存在,本身不表示镜像损坏。传统单平台存储下,可以按容器的ImageID读取本地镜像:

container_image_id=$(docker inspect --format '{{.Image}}' myapp) &&
  docker image inspect --format '{{.Os}}/{{.Architecture}}' "$container_image_id"

如果同一镜像标识下面保存了多个平台,不要把image inspect默认选出的平台直接当成容器所用平台,应以上面的容器清单信息及创建时的平台参数核对。当前版本无法给出这些证据时,结合原部署记录继续确认,不凭标签名下结论。

例如daemon是linux/amd64,实际选中的程序却来自linux/arm64,且现场没有相应模拟支持,就需要换用兼容平台。多平台标签本身不是问题:它可以同时提供多个变体,关键是本次实际选择了哪一个。

架构相同,还要看真正执行的入口

docker inspect --format 'Path={{.Path}} Args={{json .Args}}' myapp
docker inspect --format '{{json .Mounts}}' myapp
docker logs --tail 60 myapp

Path和Args帮助定位启动时执行的程序。再对照Compose中的entrypoint、command及挂载:宿主机脚本覆盖了镜像里的入口文件,或者构建时把另一种架构的二进制直接COPY进镜像,都可能造成镜像标签看起来正确、实际程序仍不能执行。

入口是脚本时,再检查解释器声明、实际解释器和换行格式,具体步骤见Linux脚本无法执行排查。入口是编译后的程序,应核对构建产物的目标架构及所需运行环境。不要把所有错误一概归为CPU不兼容;程序尚未启动时,应用日志为空也很正常,State.Error仍值得保留。

选择兼容镜像,再按原部署方式更新

机器上已有Buildx时,可查询发布方固定版本的远端清单。下列地址只是格式示例,替换成可信发布方的实际镜像引用;这一步访问镜像仓库,但不会启动容器:

docker buildx imagetools inspect registry.example.com/team/app:1.2.3

确认清单提供所需平台,再检查原Compose是否写死了不适合当前宿主机的platform。修正这一项或更换已核验的原生架构镜像,不能随手把所有环境都改成amd64。--platform只是选择目标平台,不会把现有二进制自动转换成另一种架构。

模拟运行需要相应支持,并有性能和兼容性代价,不应作为生产服务器的默认补救。不要为此直接给陌生容器privileged或改宿主机执行规则。已有跨架构方案则按该方案的实际支持范围排查。

正式更新前记录旧镜像标识和配置,确认数据备份、应用数据格式兼容性及维护窗口;更新与回退按Docker应用版本回退教程准备。重建目标服务后重新读取平台与启动状态,观察日志,并核对应用版本、原持久化数据和一次真实业务操作。镜像成功下载或容器短暂显示Up,都不能代替这些检查。