Apache不直接管理Python包依赖，部署失败常因mod_wsgi加载的Python环境与项目虚拟环境不一致，导致ImportError；需通过mod_wsgi.__file__和.wsgi中sys.executable确认真实解释器，再用pip check、pipdeptree排查版本冲突，并在WSGIDaemonProcess中显式指定python-path指向虚拟环境site-packages。
Apache 本身不直接管理 Python 包依赖，但当你用 Apache + mod_wsgi 部署 Python Web 应用（如 Flask、Django、Superset）时，启动失败常源于 Python 环境中的包版本冲突——而 Apache 只是“受害者”，错误日志里往往只显示 ImportError 或 ModuleNotFoundError，真正问题藏在 WSGI 脚本加载时的 Python 运行环境中。
排查关键点不是改 Apache 配置，而是确认：mod_wsgi 加载的是哪个 Python 解释器？它里面装了哪些包？版本是否兼容？
? 先定位 Python 环境和解释器路径
mod_wsgi 编译时绑定了特定 Python 版本和路径。若你混用系统 Python、conda 环境、venv，极易出错。
-
查看 mod_wsgi 使用的 Python：
立即学习“Python免费学习笔记（深入）”；
python -c "import mod_wsgi; print(mod_wsgi.__file__)" # 输出类似：/usr/local/lib/python3.9/site-packages/mod_wsgi/server/mod_wsgi.cpython-39-x86_64-linux-gnu.so # 说明它链接的是 Python 3.9
-
确认 Apache 启动时实际调用的 Python 解释器： 在你的
.wsgi文件开头加一行调试输出（临时）：import sys with open('/tmp/wsgi_python_info.log', 'w') as f: f.write(f"Python executable: {sys.executable}\n") f.write(f"Python version: {sys.version}\n") f.write(f"sys.path:\n" + "\n".join(sys.path))然后重启 Apache，访问一次应用，再查看
/tmp/wsgi_python_info.log—— 这才是真实运行环境。
⚠️ 常见陷阱：你激活了 venv 并
pip install了包，但 mod_wsgi 用的是系统 Python，根本没读你的虚拟环境。
? 检查该 Python 环境下的依赖是否冲突
进入上一步确认的 sys.executable 对应的 Python 环境（比如 /usr/bin/python3.9 或 /home/user/venv/bin/python），执行：
-
快速扫描冲突：
/path/to/your/python -m pip check
若输出
No broken requirements found.✅，基本排除显性冲突；若报xxx requires yyy>=2.0, but you have yyy==1.8.2❌，就找到了根因。 -
查看关键包真实版本（比如你项目用到的
flask,sqlalchemy,superset,pydantic）：/path/to/your/python -m pip show flask sqlalchemy pydantic
-
绘制依赖树，找“谁在拉低/抬高版本”：
/path/to/your/python -m pip install pipdeptree /path/to/your/python -m pipdeptree --conflicts # 或查某个包被谁依赖（例如 pydantic 冲突）： /path/to/your/python -m pipdeptree --reverse --package pydantic
? 示例：
superset==3.0.0要求pydantic，但 <code>flask-openapi3又要求pydantic>=2.5.0→ 冲突直接触发ImportError: cannot import name 'BaseModel'（因 API 完全不兼容）。
?️ 解决方案：让 mod_wsgi 正确使用你的 Python 环境
不能靠 source venv/bin/activate 启动 Apache（它不生效）。必须显式配置：
-
方式一：编译 mod_wsgi 时指定 Python（推荐长期稳定项目）
./configure --with-python=/home/user/myproject/venv/bin/python make && sudo make install
-
方式二：在 Apache 配置中指定 Python 路径（无需重编译）
在httpd.conf或虚拟主机配置中加入：WSGIDaemonProcess myapp python-path=/home/user/myproject:/home/user/myproject/venv/lib/python3.9/site-packages WSGIProcessGroup myapp WSGIScriptAlias / /home/user/myproject/app.wsgi
✅
python-path要包含你的项目目录 + venv 的site-packages，确保能 import 项目模块和依赖包。 -
方式三：在
.wsgi文件里手动插入路径（快速验证用）import sys import site # 强制添加 venv site-packages venv_site = '/home/user/myproject/venv/lib/python3.9/site-packages' site.addsitedir(venv_site) sys.path.insert(0, '/home/user/myproject') from myapp import app as application
? 附：常见干扰项清理
-
删除
.pyc和__pycache__（尤其多版本 Python 共存时缓存可能错乱）：find /home/user/myproject -name "*.pyc" -delete find /home/user/myproject -name "__pycache__" -type d -exec rm -rf {} + -
检查是否多个同名包被安装（比如
pydantic和pydantic-core冲突）：/path/to/python -m pip list | grep -i pydantic # 若看到 pydantic 1.x 和 2.x 同时存在，卸载旧版：pip uninstall pydantic==1.10.12
确保
mod_wsgi和 Python 主版本严格匹配（如 Python 3.9.18 → mod_wsgi 必须用 3.9 编译，不能混用 3.10 的 so 文件）。
不复杂但容易忽略
