Apache部署Django：PYTHONPATH设置失败及相关问题求助

问题核心原因 #

1. mod_wsgi与Python版本绑定冲突：你的Apache加载的mod_wsgi模块是基于系统Python3.6编译的，它会强制使用/usr/bin/python3作为解释器，无视你配置的WSGIPythonHome或python-home参数，导致虚拟环境的Python3.8无法被正确加载，出现版本不匹配的情况。
2. Python环境初始化失败：用错误的Python解释器加载虚拟环境的库，导致核心模块encodings找不到，直接中断WSGI进程初始化，进而引发网关超时。
3. PYTHONPATH未生效：由于Python环境本身加载异常，后续的PYTHONPATH配置无法被正常读取和应用。

解决方案 #

1. 重新编译mod_wsgi适配虚拟环境Python3.8 #

先卸载系统自带的mod_wsgi包，再用虚拟环境的Python重新安装：

# 激活虚拟环境
source /data/anaconda3/envs/partsdb/bin/activate
# 安装mod_wsgi
pip install mod_wsgi
# 生成Apache配置片段
mod_wsgi-express module-config

将输出的配置内容（示例如下）添加到Apache主配置文件中：

LoadModule wsgi_module "/data/anaconda3/envs/partsdb/lib/python3.8/site-packages/mod_wsgi/server/mod_wsgi-py38.cpython-38-x86_64-linux-gnu.so"
WSGIPythonHome "/data/anaconda3/envs/partsdb"
WSGIPythonPath "/data/anaconda3/envs/partsdb/lib/python3.8/site-packages"

2. 修正Apache的WSGI守护进程配置 #

使用WSGIDaemonProcess明确指定虚拟环境的Python解释器路径，同时配置正确的应用路径：

WSGIDaemonProcess partsdb \
    python-path=/data/partsdb \
    python-home=/data/anaconda3/envs/partsdb \
    python-interpreter=/data/anaconda3/envs/partsdb/bin/python3

WSGIProcessGroup partsdb
WSGIScriptAlias / /data/partsdb/partsdb/wsgi.py process-group=partsdb application-group=%{GLOBAL}

<Directory "/data/partsdb/partsdb">
    <Files wsgi.py>
        Require all granted
    </Files>
</Directory>

注意：python-interpreter必须指定虚拟环境的Python二进制文件路径，确保mod_wsgi调用正确的解释器。

3. 验证配置并重启Apache #

# 检查Apache配置语法
apachectl configtest
# 重启Apache服务
systemctl restart httpd

4. 额外验证步骤 #

• 执行/data/anaconda3/envs/partsdb/bin/python3 -c "import sys; print(sys.path)"，确认输出包含项目路径/data/partsdb。
• 查看Apache错误日志（通常在/var/log/httpd/error_log），确认没有ModuleNotFoundError或Python初始化错误。

内容的提问来源于stack exchange，提问作者Shiping