Mac端基于Buildroot构建arm64架构scratch Docker镜像运行报错求助

问题根因及修复方案 #

1. 直接报错原因：docker run 参数顺序错误

docker run 的全局参数必须放在镜像名之前，你把--platform linux/arm64写在镜像名后面，会被当作/bin/sh的传入参数，Docker不会识别为指定运行架构的配置，导致Docker默认用宿主机amd64架构启动arm64镜像，触发exec format error。

修正后的运行命令：

docker run --privileged --platform linux/arm64 --entrypoint "/bin/sh" -it "$DOCKER_USER/testrtfs:latest"

2. 其他可能的故障点（如果修正命令后仍报错）

• Buildroot编译配置错误：确认编译时的目标架构配置是否正确：
  • Target options -> Target Architecture选AArch64 (little endian)
  • Target Architecture variant选cortex-a53
  • C library选uClibc-ng
  • 建议勾选Build static packages，或确保动态链接器路径与rootfs内路径完全匹配
• rootfs打包完整性检查：确认导出的rootfs.tar内包含/lib/ld-uClibc.so.1（arm64 uclibc的动态链接器）和/bin/sh，且两者都是arm64架构，可在Buildroot编译环境内执行以下命令验证：

  file /path/to/rootfs/bin/sh
  # 正确输出应为：/path/to/rootfs/bin/sh: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-uClibc.so.1, for GNU/Linux 4.15.0, stripped
  

• Docker Desktop 架构模拟配置确认：确保Docker Desktop已开启binfmt_misc支持，可执行以下命令验证：

  docker run --privileged --rm tonistiigi/binfmt --install all
  

3. 后续Pyinstaller打包注意事项

进入运行正常的arm64 uclibc容器后，安装Python和Pyinstaller，直接在容器内执行打包操作，生成的可执行文件即可直接在目标Cortex A53设备上运行。

内容的提问来源于stack exchange，提问作者Kevin Riordan