Django配置Apache+mod_wsgi报错：找不到'encodings'模块求助

问题本质 #

日志里的ModuleNotFoundError: No module named 'encodings'和init_fs_encoding错误，核心是mod_wsgi加载的Python环境与你的conda虚拟环境不兼容，或者Apache进程没有正确读取虚拟环境的完整路径。从日志可见，系统Python（/usr/bin/python3）被用来加载conda虚拟环境的路径，导致编码模块无法找到。

排查与解决步骤 #

1. 检查mod_wsgi与Python虚拟环境的兼容性 #

mod_wsgi必须和目标Python版本同版本编译，如果你的mod_wsgi是用系统Python编译的，直接指向conda虚拟环境必然冲突：

• 执行以下命令查看mod_wsgi关联的Python路径：

  mod_wsgi-express module-config
  

  如果输出的Python路径不是你的conda虚拟环境（/data/anaconda3/envs/partsdb/bin/python3.8），需要重新编译mod_wsgi：

  # 卸载系统自带的mod_wsgi
  sudo dnf remove mod_wsgi
  # 激活conda虚拟环境
  conda activate partsdb
  # 安装并编译mod_wsgi到当前环境
  pip install mod_wsgi
  # 生成Apache所需的模块配置
  mod_wsgi-express module-config
  

  将输出的LoadModule wsgi_module ...等内容，替换Apache主配置文件（如/etc/httpd/conf/httpd.conf）中原有的mod_wsgi加载配置。

2. 修正Apache的WSGI配置错误 #

你后续的配置里存在路径拼写错误：虚拟环境路径写成了/data/anaconda3/envs/hla3db_venv，但实际是/data/anaconda3/envs/partsdb。同时调整python-path指向项目根目录：

# 设置编码环境变量，避免文件系统编码问题
SetEnv LC_ALL en_US.UTF-8
SetEnv LANG en_US.UTF-8

WSGIDaemonProcess partsdb python-path=/data/partsdb python-home=/data/anaconda3/envs/partsdb
WSGIProcessGroup partsdb
WSGIScriptAlias / /data/partsdb/partsdb/wsgi.py

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

3. 确保Apache进程有权限访问路径 #

RedHat 8的Apache默认以apache用户运行，需给虚拟环境和项目目录添加读取权限：

# 给conda虚拟环境添加读取权限
sudo chmod -R o+rX /data/anaconda3/envs/partsdb
# 给Django项目目录添加读取权限
sudo chmod -R o+rX /data/partsdb
# 如果有静态/媒体文件需要写入，调整所有者
sudo chown -R apache:apache /data/partsdb/static /data/partsdb/media

4. 验证虚拟环境完整性 #

如果上述步骤无效，可能是conda虚拟环境损坏，重新创建环境：

conda deactivate
conda remove -n partsdb --all
conda create -n partsdb python=3.8
conda activate partsdb
# 安装依赖
pip install django mod_wsgi
pip install -r /data/partsdb/requirements.txt

5. 测试与验证 #

修改配置后重启Apache：

sudo systemctl restart httpd

查看错误日志排查问题：

journalctl -u httpd
# 或直接查看Apache日志文件
cat /var/log/httpd/error_log

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