Python项目Nginx启动失败若报ImportError等，主因是uWSGI/Gunicorn实际运行环境与开发环境不一致，需通过ps aux定位真实Python路径，用pip show/pipdeptree查版本冲突，以pip-compile重建依赖并强制使用独立venv隔离。
Python 项目在 Nginx（通常配合 uWSGI 或 Gunicorn）中启动失败，若错误日志里反复出现 ImportError、AttributeError 或 ModuleNotFoundError，且指向某个第三方包（如 requests、pydantic、numpy），大概率不是 Nginx 配置问题，而是 Python 环境的依赖版本冲突。排查需从 Nginx 进程实际使用的 Python 环境切入，而非本地开发环境。
确认 Nginx 后端进程调用的真实 Python 环境
Nginx 本身不运行 Python，它通过反向代理把请求转给 uWSGI/Gunicorn 进程。这些进程可能使用系统 Python、宝塔内置 Python、或你手动创建的虚拟环境——但往往和你在终端里 pip list 查到的不是同一个。
- 查 uWSGI/Gunicorn 启动命令：在宝塔面板“进程管理”或用
ps aux | grep uwsgi找到完整命令行，重点看--pythonpath、--virtualenv、-c（配置文件路径）等参数 - 进入该进程所在目录，执行其启动脚本中的 Python 解释器路径，例如：
/www/server/python/bin/python3.10 -c "import sys; print(sys.executable); import requests; print(requests.__version__)" - 若报错或版本与预期不符，说明 Nginx 背后跑的是另一个环境，所有后续排查都必须在这个环境下进行
在真实运行环境中定位冲突包
别依赖本地 requirements.txt，要以运行时环境为准：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 在上一步确认的 Python 环境下，运行：
pip show 包名（如pip show pydantic），看实际装的是哪个版本 - 运行：
pipdeptree --conflicts，直接列出所有带[conflict]的包。例如输出pydantic==2.9.2 [requires: typing-extensions>=4.12.0] └── fastapi==0.115.0 [requires: typing-extensions>=4.8.0,!=4.12.2] [conflict]，说明typing-extensions版本被卡住 - 用
pipdeptree --reverse --package typing-extensions查清是哪个高层包（如fastapi或httpx）在强制约束该依赖
验证并修复版本组合
找到冲突点后，不能只改一个包，要确保整条依赖链闭合：
立即学习“Python免费学习笔记（深入）”；
- 先尝试最小改动：卸载冲突包，安装一个被多方接受的中间版本，例如：
pip uninstall typing-extensions && pip install typing-extensions==4.11.0 - 重启 uWSGI/Gunicorn（不是只 reload，要 stop 再 start），观察日志是否消失。若仍报错，说明还有隐藏依赖未覆盖
- 更可靠的做法是重建锁文件：在该环境里新建
requirements.in（只写顶层依赖，如fastapi、sqlalchemy），然后运行pip-compile requirements.in生成精确的requirements.txt，再pip install -r requirements.txt - 完成后，务必执行
pip check—— 它会明确告诉你“No broken requirements found”还是列出剩余冲突
防止 Nginx 下多项目互相污染
宝塔或手动部署时，多个 Python 站点共用一个 Python 环境是冲突高发区：
- 每个站点必须使用独立虚拟环境：用
python3.10 -m venv /www/wwwroot/myapp/venv创建，并在 uWSGI/Gunicorn 配置中显式指定--virtualenv /www/wwwroot/myapp/venv - 禁用全局 pip 安装：在宝塔 Python 管理中，避免点击“一键安装”，所有依赖都应在对应 venv 的 bin 目录下执行
./pip install - 静态资源路径也要隔离：Nginx 的
location /static/必须指向该站点自己的venv或项目内 static 目录，不能跨站复用
