EC2实例中Apache+Miniconda+mod_wsgi模块导入错误求助

我碰到过不少用户在EC2上用Miniconda虚拟环境搭配mod_wsgi时遇到这个「encodings模块未找到」的错误，结合你提到的strace结果（httpd尝试访问虚拟环境不存在的/lib64目录），问题根源基本是mod_wsgi没有和Miniconda虚拟环境的Python版本正确绑定，或者WSGI配置里的路径指向有误。下面是一步步的解决方案：

1. 确保mod_wsgi用虚拟环境的Python编译 #

mod_wsgi是和Python版本强绑定的——不能用系统自带的mod_wsgi去加载Miniconda虚拟环境的Python。你需要重新用虚拟环境的Python编译安装mod_wsgi：

• 激活你的Miniconda虚拟环境：

  conda activate your_env_name
  

• 用虚拟环境的pip安装mod_wsgi：

  pip install mod_wsgi
  

• 生成模块配置命令，复制输出的内容：

  mod_wsgi-express module-config
  

• 打开Apache的httpd.conf，替换掉原来的mod_wsgi加载配置，比如把输出的这几行加进去：

  LoadModule wsgi_module /home/ec2-user/miniconda3/envs/your_env/lib/python3.9/site-packages/mod_wsgi/server/mod_wsgi-py39.so
  WSGIPythonHome /home/ec2-user/miniconda3/envs/your_env
  

  注意：WSGIPythonHome必须指向虚拟环境的根目录，不是bin或者lib子目录。

2. 修正WSGIDaemonProcess的配置 #

在httpd.conf里调整WSGI进程配置，明确指定虚拟环境路径，避免Apache去系统路径找依赖：

WSGIDaemonProcess your_app_name \
    python-home=/home/ec2-user/miniconda3/envs/your_env \
    python-path=/var/www/your_app  # 你的应用代码目录
WSGIProcessGroup your_app_name
WSGIScriptAlias / /var/www/your_app/wsgi.py

这里的python-home一定要准确指向虚拟环境的根目录，这会告诉mod_wsgi从这个路径加载Python的核心模块，包括encodings。

3. 检查虚拟环境权限与完整性 #

• 确保Apache用户（EC2上通常是apache用户）有访问虚拟环境目录的权限：

  sudo chown -R apache:apache /home/ec2-user/miniconda3/envs/your_env
  sudo chmod -R 755 /home/ec2-user/miniconda3/envs/your_env
  

• 如果虚拟环境可能损坏，可以重新创建一个干净的环境试试：

  conda create -n new_env python=3.9  # 用你需要的Python版本
  conda activate new_env
  # 重新安装你的应用依赖
  

4. 解决LD_LIBRARY_PATH的路径问题 #

从strace结果看，httpd在找/lib64目录，这是系统Python的库路径。你可以在Apache配置里重置环境变量，强制让它用虚拟环境的lib目录：
在httpd.conf里添加：

SetEnv LD_LIBRARY_PATH /home/ec2-user/miniconda3/envs/your_env/lib

或者直接在WSGIDaemonProcess里指定环境变量：

WSGIDaemonProcess your_app_name \
    python-home=/home/ec2-user/miniconda3/envs/your_env \
    python-path=/var/www/your_app \
    environment=LD_LIBRARY_PATH=/home/ec2-user/miniconda3/envs/your_env/lib

为什么会出现这个问题？ #

Miniconda的虚拟环境结构和系统Python不同，它把核心库放在lib目录下，而不是系统Python的lib64。如果mod_wsgi没有正确关联虚拟环境，就会沿用系统Python的路径去查找，自然找不到encodings这类核心模块。只要把mod_wsgi和虚拟环境的Python绑定好，路径指向正确，这个问题就能解决。

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