Debian10 GCE实例Python3.7环境安装mediapipe失败问题咨询
2026-10-15
问题原因排查
- pip版本不符合要求：当前使用的pip 18.1版本过低，不支持
manylinux_2_17（manylinux2014）的wheel包标签，该标签只有pip 20.3及以上版本才能正常识别。旧版pip会将符合规则的mediapipe安装包判定为与当前平台不兼容，因此在线安装时找不到匹配版本，手动安装wheel包也会报错。 - 无其他系统性兼容问题：Debian 10 (buster)自带的glibc版本为2.28，满足mediapipe对Linux系统的最低依赖要求，CPU架构amd64也和官方发布包的适配架构一致。
解决方案
- 首先升级pip到符合要求的版本，执行命令：
pip3 install --upgrade pip
如果当前账号无全局安装权限，可添加--user参数执行用户目录下的局部升级：pip3 install --upgrade pip --user - 验证pip版本，执行命令确认版本号≥20.3：
pip3 --version - 重新安装mediapipe，按需选择对应安装方式：
- 在线安装最新版本执行：
pip3 install mediapipe - 安装指定0.8.5版本执行：
pip3 install mediapipe==0.8.5 - 若使用已下载的wheel包安装，直接执行原手动安装命令即可：
pip3 install mediapipe-0.8.5-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- 在线安装最新版本执行：
异常情况排查（如执行上述步骤后仍安装失败）
- 执行命令检查Python架构，确认输出为64bit：
python3 -c "import platform; print(platform.architecture()[0])"，若为32bit需要更换为64位Python环境。 - 执行命令检查glibc版本，确认输出版本≥2.17：
ldd --version，若版本过低需要升级系统glibc库或更换更高版本的操作系统。
内容的提问来源于stack exchange，提问作者Aneesh Jose
相关产品推荐
相关产品推荐
