跳转到主内容
websoft网络软件专家 - 深耕网络技术,打造实用软件!

安装宝塔面板提示Python环境错误_手动修复依赖库兼容性

宝塔面板启动报 ModuleNotFoundError: No module named 'gevent',本质是Python环境断裂:需用宝塔专属路径 /www/server/panel/pyenv/bin/pip 安装指定版本的 gevent==21.12.0、greenlet==1.1.2、psutil==5.9.4,并规避GLIBC、DNS、pip升级等兼容性问题。 宝塔面板启动报
ModuleNotFoundError: No module named 'gevent'
这是最典型的 Python 环境断裂信号:宝塔 7.x/8.x 默认依赖
gevent
、
greenlet
、
psutil
这几个核心库,但系统 Python 升级或手动装过新版 pip 后,它们常因 ABI 不兼容或版本错位直接失效。 别急着重装宝塔——90% 的情况是库没装对环境,而不是面板坏了。 先确认宝塔实际用的 Python 路径:
/www/server/panel/pyenv/bin/python
(不是系统
/usr/bin/python
) 必须用这个路径下的
pip
安装,否则装到哪去都不知道:
/www/server/panel/pyenv/bin/pip install --force-reinstall gevent==21.12.0 greenlet==1.1.2 psutil==5.9.4
gevent
严格绑定
greenlet
版本,
greenlet>=2.0.0
会导致宝塔 Web 服务起不来,必须锁死在
1.1.2
如果提示
gcc
缺失,说明编译扩展失败,要先装:
yum groupinstall "Development Tools"
(CentOS)或
apt install build-essential
(Ubuntu/Debian) 执行
bt restart
卡在 “正在启动面板服务” 表面是服务没起来,本质是 Python 子进程崩溃后反复拉起失败。日志里通常藏一句关键报错:
ImportError: /lib64/libc.so.6: version `GLIBC_2.18' not found
—— 这意味着你装的
gevent
轮子(wheel)是用高版本 GLIBC 编译的,而你的系统(比如 CentOS 7)只有 GLIBC 2.17。 绕过 wheel,强制源码编译:
/www/server/panel/pyenv/bin/pip install --no-binary :all: --force-reinstall gevent==21.12.0
CentOS 7 用户慎用
pip install --upgrade pip
,新版 pip 会默认优先下高 GLIBC 轮子,降级回
pip==21.3.1
更稳 检查
/www/server/panel/logs/error.log
,重点看最后一段 traceback,它比控制台输出更全 面板能打开但网站打不开,
nginx
日志报
upstream prematurely closed connection
这不是 Nginx 问题,是宝塔后端(
panelBoot.py
)和前端通信断了。根本原因往往是
gevent
的 DNS 解析模块在某些内网或 DNS 配置异常的机器上卡死,导致整个异步循环阻塞。 立即学习 “ Python免费学习笔记(深入) ”; 临时验证:停掉面板,手动跑一次:
/www/server/panel/pyenv/bin/python /www/server/panel/class/panelSafe.py
,看是否卡住或报 DNS 相关 timeout 永久修复:编辑
/www/server/panel/pyenv/lib/python3.7/site-packages/gevent/_socketcommon.py
,在开头加一行:
import socket; socket.setdefaulttimeout(5)
更稳妥的做法是换用系统默认 resolver,删掉
/etc/resolv.conf
里非 114.114.114.114 或 8.8.8.8 的 DNS 行,避免 gevent 拿到慢 DNS 后死等 升级宝塔后 Python 报错变多,
pip list
显示一堆
UNKNOWN
包 这是宝塔升级脚本暴力覆盖了
pyenv
的
site-packages
,把原本正常的
dist-info
目录搞丢了。包还在,但 pip 认不出来,后续安装/卸载全乱套。 别信
pip check
,它这时候基本废的;直接进目录看:
ls /www/server/panel/pyenv/lib/python3.7/site-packages/ | grep -E "(gevent|greenlet|psutil)"
发现有
gevent-21.12.0.dist-info
但没内容?用
rm -rf
干掉整个
.dist-info
文件夹,再重装对应版本 终极兜底:备份好
/www/server/panel/data
和网站目录,删掉整个
/www/server/panel/pyenv
,然后执行
curl http://download.bt.cn/install/update6.sh|bash
让升级脚本重建干净环境 Python 依赖的坑不在代码里,在路径、ABI、DNS、GLIBC 这些看不见的地方。修的时候盯着
/www/server/panel/pyenv/bin/python
这个路径别偏移,其它都是枝节。

相关文章