Jenkins构建的Pyinstaller可执行文件在树莓派4上格式无效求助

核心原因：CPU架构不兼容 #

你在5.10.0-23-cloud-amd64（x86_64架构）系统上，用python:3.11镜像构建的可执行文件是x86_64架构的二进制程序。而你的树莓派4运行的是aarch64（ARM64）架构系统，两种架构的指令集完全不同，ARM设备无法直接运行x86_64的程序，这就是报错-bash: ./main: binary is not executable: invalid file format的根本原因。

验证方式 #

用file命令可以确认二进制文件的架构：

• 在构建机器上执行：file main，输出会显示类似ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2
• 在树莓派上执行同样命令，会明确指出该文件是x86_64架构，与当前aarch64系统不匹配。

可行解决办法 #

• 直接在树莓派上构建：在树莓派4上安装Python3.11和PyInstaller，执行pyinstaller --onefile main.py，生成的二进制是aarch64架构，能直接运行。
• 用Docker ARM64镜像交叉构建：在x86_64机器上启用Docker buildx功能，拉取python:3.11的ARM64版本镜像构建。示例流程：
  1. 编写简单Dockerfile：

     FROM python:3.11
     WORKDIR /app
     COPY main.py .
     RUN pip install pyinstaller
     RUN pyinstaller --onefile main.py
     

  2. 执行构建命令：

     docker buildx build --platform linux/arm64 -o type=local,dest=./dist .
     

     构建完成后，dist目录里的可执行文件就是ARM64架构的。
• 用QEMU模拟ARM环境构建：在x86_64机器上安装QEMU，让Docker可以模拟ARM64架构运行镜像，再用ARM版Python镜像完成构建。

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