0

0

OpenRV 构建失败:解决 brotli 等依赖包轮子(wheel)编译问题

聖光之護

聖光之護

发布时间:2026-01-02 13:39:18

|

638人浏览过

|

来源于php中文网

原创

OpenRV 构建失败:解决 brotli 等依赖包轮子(wheel)编译问题

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 构建流程。

推荐解决方案(按优先级排序)

  1. 降级 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
  2. 强制使用预编译 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 是最可靠方案。
  3. 验证依赖兼容性(辅助排查)
    手动检查各包对 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 运行时稳定性。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

720

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

627

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

744

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1236

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

575

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

700

2023.08.11

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 6.4万人学习

Git 教程
Git 教程

共21课时 | 2.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号