首页·报错信息

docker · Docker

报错原文

exec /usr/local/bin/entrypoint.sh: exec format error

这是什么意思

内核认不出那个可执行文件的头部,而如今这几乎总是架构不匹配——在 Apple Silicon 上构建的 arm64 镜像跑在 amd64 主机上,或者反过来。shell 脚本少了第一行 #!/bin/sh 时也会打出同样的字。用 docker build --platform=linux/amd64 构建是常见做法,但它不是消除不匹配,而是用模拟把它盖住:经过 QEMU 的运行比原生慢好几倍。要长期使用的镜像,用 buildx 同时构建两种架构,才是运行时不付代价的路。

怎么修

docker build --platform=linux/amd64 .
来自
docker
Docker
12

docker 的错误要先归到某一层才读得懂——客户端连不上守护进程、镜像仓库拒绝你、构建过程中某条 RUN 失败、容器一起来就死掉,是四种不同的问题——而在构建和运行这两层,那行字本身并不是原因:原因在里面那条命令留下的输出里,各层修复的代价也不一样。

怎么读报错

  • 从第一行往下读。越往下越是工具内部的事,起因通常写在最上面。
  • 有文件名和行号就从那里查——不是栈顶那一帧,而是最上面那条提到你自己写的文件的行。
  • 把报错原文照样去搜,但先去掉你自己的路径和变量名,正是那些让搜索匹配不上。
  • 同一种情况在不同版本里措辞不同。结果不对头,就把版本号一起加进查询。
  • 粘贴修法之前,先确认它会丢掉什么。这里面有些是不能撤回的。

常见问题

Q. “exec /usr/local/bin/entrypoint.sh: exec format error” 是什么意思?

内核认不出那个可执行文件的头部,而如今这几乎总是架构不匹配——在 Apple Silicon 上构建的 arm64 镜像跑在 amd64 主机上,或者反过来。shell 脚本少了第一行 #!/bin/sh 时也会打出同样的字。用 docker build --platform=linux/amd64 构建是常见做法,但它不是消除不匹配,而是用模拟把它盖住:经过 QEMU 的运行比原生慢好几倍。要长期使用的镜像,用 buildx 同时构建两种架构,才是运行时不付代价的路。

Q. 怎么修?

docker build --platform=linux/amd64 . —— 执行前先看上面的说明,确认这条命令会丢掉什么。

Q. 这是哪个工具报的?

docker。它属于Docker,报错原文有 5 个词。

相关报错