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