解决64位树莓派通过pip安装pyads时的ELFCLASS32错误

问题背景 #

运行64位Linux内核（6.1.0-rpi7-rpi-2712）、Python 3.11.2的树莓派上，通过pip安装pyads 3.3.9后导入时出现以下错误：

OSError: /usr/local/lib/python3.11/dist-packages/pyads/adslib.so: wrong ELF class: ELFCLASS32

该错误源于pyads附带的adslib.so为32位编译版本，与树莓派的aarch64 64位架构不兼容。

问题解答 #

1. 64位树莓派环境下的自动化解决方案 #

有两种无需手动克隆源码的自动化实现方式：

• 强制pip从源码编译安装：使用--no-binary :all:参数让pip跳过预编译wheel，直接在本地64位环境编译适配的adslib.so。执行命令前需确保系统具备编译依赖：

  # 先安装编译依赖（可写入自动化脚本）
  sudo apt-get update && sudo apt-get install -y build-essential python3-dev
  # 从源码编译安装pyads
  pip install pyads==3.3.9 --no-binary :all:
  

  整个流程可封装为shell脚本，部署时一键执行即可完成自动化安装。
• Docker容器化部署：基于64位树莓派的基础镜像构建容器，在容器内部完成pyads的编译安装，后续直接复用容器镜像实现无缝部署，避免宿主机环境依赖问题。

2. pyads对64位aarch64的pip自动兼容计划 #

目前pyads官方发布的预编译wheel包暂未覆盖aarch64架构。从社区反馈来看，项目团队已收到多架构支持的需求，有计划扩展预编译wheel的覆盖范围，但具体时间线尚未明确。你可以关注项目的版本更新日志，或提交需求反馈推动功能落地。

无缝部署场景的额外建议 #

• 封装自动化安装脚本：将依赖安装、pyads编译安装的命令整合为单脚本，部署时直接执行即可消除手动操作步骤。
• 监控版本更新：一旦pyads官方发布支持aarch64的预编译wheel，即可直接使用pip install pyads完成无缝安装。

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