pyzmq v26.0.0a2 在Raspberry Pi OS上的构建问题分析

问题背景

在Raspberry Pi OS（Bullseye 32位）环境下，当用户尝试从源代码构建pyzmq v26.0.0a2版本时遇到了构建失败的问题。这个问题在使用预构建的libzmq 4.3.5库时出现，而之前的pyzmq版本构建是成功的。

环境配置

用户的环境配置如下：

• 操作系统：Raspberry Pi OS Bullseye 32位
• Python版本：3.9.2（通过apt-get安装）
• libzmq版本：4.3.5（预构建并安装在/usr/local目录下）
• 构建参数：
  • ZMQ_PREFIX="/usr/local"
  • ZMQ_DRAFT_API=1
  • 使用pip install -v --no-binary pyzmq --pre pyzmq命令安装

错误现象

构建过程中，CMake配置阶段顺利完成，但在生成Cython后端时失败。具体错误表现为：

[ 33%] Generating zmq/backend/cython/_zmq.c
[Errno 2] No such file or directory: '/tmp/tmp0idg8ze3/build/zmq/backend/cython/_zmq.c'

问题分析

从错误日志可以看出，构建系统尝试在临时目录中生成Cython转换后的C文件时，目标目录不存在。这表明构建系统在创建必要的目录结构时存在问题。

值得注意的是：

1. 这个问题在pyzmq v26之前的版本中不存在
2. 同样的构建方式在Raspberry Pi OS Bookworm（Python 3.11）上也失败
3. 构建过程中启用了ZMQ_DRAFT_API支持

解决方案

pyzmq开发团队在收到报告后迅速响应，发布了v26.0.0a3版本修复了这个问题。修复的主要改动是确保在构建过程中正确创建了backend目录结构。

技术建议

对于需要在嵌入式设备（如树莓派）上构建pyzmq的用户，建议：

1. 确保系统已安装所有必要的构建工具（如CMake、Cython等）
2. 如果使用预构建的libzmq，确保正确设置了ZMQ_PREFIX环境变量
3. 对于需要Draft API支持的情况，可以设置ZMQ_DRAFT_API=1
4. 考虑使用最新稳定版本而非预发布版本，除非确实需要新特性

后续更新

开发团队还注意到文档中关于需要使用--pre标志来启用Draft API的描述已经过时，计划更新相关文档。实际上，现代版本的pyzmq已经不需要使用预发布版本来获得Draft API支持。

这个案例展示了开源社区如何快速响应和解决用户报告的问题，也提醒用户在遇到构建问题时提供详细的系统环境和错误日志，有助于开发者快速定位和修复问题。