宝塔Python项目ModuleNotFoundError的根本原因是解释器路径不一致：项目配置的Python路径（如/usr/bin/python3）与pip安装依赖的虚拟环境路径（如/venv/bin/python3）不同，导致包装错位置。
宝塔里 Python 项目启动报 ModuleNotFoundError，先查 python 路径对不对
根本问题不是“没装包”，而是宝塔用的 python 解释器和你装依赖时用的根本不是同一个。比如你在项目里建了 venv，但宝塔项目管理器里 Python 版本下拉框选的是系统默认的 /usr/bin/python3，那 pip 安装的包全进了系统 site-packages，而项目运行时却从虚拟环境里找模块——自然找不到。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 进宝塔「Python项目管理器」→ 编辑项目 → 看「Python版本」那一栏填的是什么路径；必须是虚拟环境里的解释器，例如
/www/wwwroot/myproject/venv/bin/python3，不能只写python3或留空 - 在服务器终端手动验证：运行
/www/wwwroot/myproject/venv/bin/python3 -c "import sys; print(sys.executable)"，输出必须和面板里填的一致 - 如果填的是相对路径或命令名，宝塔会 fallback 到系统 Python，这是绝大多数
ModuleNotFoundError的源头
点「更新依赖文件」没反应？直接进终端看 pip list 和安装日志
宝塔界面显示“更新成功”，但实际可能静默失败：权限不足、网络超时、缓存冲突，它不把 pip 的 stderr 输出给你看。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 别信面板提示，直接执行：
/www/wwwroot/myproject/venv/bin/python3 -m pip list | grep requests（替换为你项目实际用的包名） - 如果没输出，说明包确实没装进去；再试安装：
/www/wwwroot/myproject/venv/bin/python3 -m pip install --force-reinstall -r /www/wwwroot/myproject/requirements.txt - 若报
PermissionError，证明python路径填错了，pip 正试图往系统目录写，比如/usr/local/lib/python3.11/site-packages - 检查
requirements.txt路径是否为绝对路径；相对路径如./requirements.txt在宝塔里会被忽略
Poetry / Pipenv 项目不能靠「更新依赖文件」，必须转成 requirements.txt
宝塔项目管理器原生只识别 requirements.txt，对 pyproject.toml 或 Pipfile 完全无感。点“更新依赖文件”等于白按。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Poetry 项目：SSH 进项目根目录，运行
poetry export -f requirements.txt --without-hashes > requirements.txt，再让宝塔更新 - Pipenv 项目：用
pipenv requirements > requirements.txt生成兼容文件 - 更稳妥的做法是跳过面板按钮，改用「定时任务」或「SSH终端」执行完整命令，比如：
cd /www/wwwroot/myproject && /www/wwwroot/myproject/venv/bin/python3 -m pip install --force-reinstall -r requirements.txt
Windows 宝塔上 Python 项目启动失败，重点查端口复用和路径注入
Windows 版宝塔 Nginx + Python 组合容易出现“重启后端就 502”或“模块能 import 但子模块找不到”的问题，核心是进程残留和 Python 模块搜索路径没补全。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 每次改完代码或依赖，先手动杀掉旧进程：
taskkill /f /im python.exe，否则新启动的实例可能被旧进程占着端口 - 如果项目有自定义模块（比如
utils/、models/），在主入口文件顶部加路径补丁：import sys, os; sys.path.append(os.path.dirname(os.path.abspath(__file__))) - 确认 Nginx 的
proxy_pass配置末尾斜杠一致：比如后端监听http://127.0.0.1:5000/，那么proxy_pass必须写成http://127.0.0.1:5000/（带斜杠），否则路径转发会错位
python 解释器路径与 pip 所属环境完全一致——哪怕多一个字符差异，都会导致依赖装进黑盒，运行时彻底失联。 
