
openrv 在 rvbootstrap 阶段因无法为 brotli、inflate64、pybcj、pycryptodomex、pyppmd 和 pyzstd 构建 wheel 而失败,主因是 python 3.11 与部分旧版依赖(尤其是 brotli)不兼容;推荐降级至 python 3.9 或 3.10 并配合预编译二进制包规避编译障碍。
OpenRV 官方明确要求 Python 3.6–3.10(参考构建文档),而你当前使用的 Python 3.11 已超出支持范围——这正是构建失败的根本原因。尤其关键的是 brotli 包:其 PyPI 页面明确标注仅支持 Python 2.7 及 3.3–3.5(Brotli 1.1.0 on PyPI),完全不兼容 Python 3.11。尽管 pycryptodomex、pyzstd 等较新包已支持 3.11,但 setup.py 或 pyproject.toml 中的依赖解析会因任一包不兼容而整体中断 wheel 构建流程。
✅ 推荐解决方案(按优先级排序):
-
降级 Python 至受支持版本
使用 pyenv(Linux/macOS)或官方安装包(Windows/MSYS2)切换至 Python 3.9.19 或 3.10.13(稳定且广泛验证):# 在 MSYS2 中(需先安装 python-pyenv) pyenv install 3.10.13 pyenv local 3.10.13 python --version # 确认输出为 Python 3.10.13
-
强制使用预编译 wheel(临时绕过编译)
若必须暂用 3.11,请在 rvbootstrap 前添加环境变量,禁用源码构建并优先从 PyPI 拉取兼容 wheel:export PIP_ONLY_BINARY="brotli,inflate64,pybcj,pycryptodomex,pyppmd,pyzstd" export PIP_NO_BUILD_ISOLATION=1 ./rvbootstrap --no-clean
⚠️ 注意:此法依赖 PyPI 是否提供对应平台的 wheel。MSYS2(即 mingw64)环境下,多数上述包无官方 wheel,因此仍可能失败——故降级 Python 是最可靠方案。
-
验证依赖兼容性(辅助排查)
手动检查各包对 Python 3.11 的支持状态:pip debug --verbose | grep "python_version" # 确认 pip 识别的 Python 版本 pip index versions brotli # 查看可用版本及支持的 Python tags pip index versions pycryptodomex
你会看到 brotli 最高仅支持到 cp35(CPython 3.5),而 pycryptodomex>=3.18.0 才开始支持 3.11。
? 重要提醒:
- OpenRV 的 CI 流水线(GitHub Actions)全部基于 Python 3.9/3.10 运行,Python 3.11 不在官方测试矩阵中;强行适配将引入不可预知的运行时错误(如解压缩异常、加密模块崩溃)。
- MSYS2 的 mingw64 工具链与 CPython 扩展编译存在固有差异,brotli 等含 C 扩展的包极易因 ABI 不匹配而编译失败——这不是配置问题,而是生态兼容性断层。
综上,请坚定采用 Python 3.10 + 官方 MSYS2 Python 包 组合,并在执行 ./rvbootstrap 前确保 which python 指向该版本。此举可 100% 规避 wheel 构建错误,并保障后续 OpenRV 运行时稳定性。









