在Apache(Wamp)部署Django应用时遭遇<exe_prefix>依赖库未找到错误

问题描述 #

在Wamp的Apache服务器上部署Django应用，使用虚拟环境时触发could not find platform dependent libraries <exe_prefix>错误，虚拟环境无法正常启动，导致应用无法运行。已尝试两种虚拟环境激活方式（activate_this.py和直接执行虚拟环境Python脚本），但问题未解决。

当前httpd-vhost.conf配置 #

<VirtualHost *:80>
    ServerName my.app.name
    ServerAdmin myadminname@localhost.com
    
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

    WSGIPassAuthorization On
    
    Alias /static C:/wamp/apache2/htdocs/<myappname>/frontend/build/static/
    <Directory "C:/wamp/apache2/htdocs/<myappname>/frontend/build/static/">
        Allow from all
        Require all granted
    </Directory>
    
    <Directory "C:/wamp/apache2/htdocs/<myappname>/<mysetting's django folder>">
        <Files wsgi.py>
            Allow from all
            Require all granted
        </Files>
    </Directory>
    
    #WSGIDaemonProcess <my.app.group> python-path="C:/wamp/apache2/htdocs/<app.name>/env/Lib/site-packages"
    #WSGIProcessGroup <my.app.group>
    WSGIScriptAlias / "C:/wamp/apache2/htdocs/<app.name>/<settings folder>/wsgi.py"
    
</VirtualHost>

当前wsgi.py内容 #

import os
import sys

# Add the virtual environment path to the system path
sys.path.append('C:/wamp/apache2/htdocs/<app.name>/env/Lib/site-packages')

# activate_this = 'C:/wamp/apache2/htdocs/<app.name>/env/Scripts/activate_this.py'
# execfile(activate_this, dict(__file__=activate_this))
# exec(open(activate_this).read(),dict(__file__=activate_this))

# Activate the virtual environment
activate_env = 'C:/wamp/apache2/htdocs/<app.name>/env/Scripts/python'
exec(open(activate_env, 'rb').read(), {'__file__': activate_env})

# Set the DJANGO_SETTINGS_MODULE environment variable
# os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'app.settings')

os.environ['DJANGO_SETTINGS_MODULE'] = 'app.settings'

# Import the Django application from the Django project
from django.core.wsgi import get_wsgi_application

application = get_wsgi_application()

解决方案 #

1. 启用WSGIDaemonProcess守护进程模式（推荐） #

Apache mod_wsgi官方推荐用守护进程模式管理虚拟环境，无需在wsgi.py中手动激活。修改httpd-vhost.conf，取消注释并完善配置：

# 配置虚拟环境路径和项目路径
WSGIDaemonProcess my.app.group python-home="C:/wamp/apache2/htdocs/<app.name>/env" python-path="C:/wamp/apache2/htdocs/<app.name>"
WSGIProcessGroup my.app.group

WSGIScriptAlias / "C:/wamp/apache2/htdocs/<app.name>/<settings folder>/wsgi.py"

• python-home：指定虚拟环境根目录，mod_wsgi会自动识别其中的Python解释器和依赖包
• python-path：添加Django项目根目录，确保能找到settings模块

2. 简化wsgi.py，移除手动激活逻辑 #

删除wsgi.py中所有虚拟环境激活代码，保留核心配置：

import os
import sys

# 添加项目根目录到系统路径
sys.path.append('C:/wamp/apache2/htdocs/<app.name>')

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'app.settings')

from django.core.wsgi import get_wsgi_application

application = get_wsgi_application()

3. 检查Python版本兼容性 #

• 确保虚拟环境使用的Python版本与Apache mod_wsgi编译时依赖的Python版本一致，版本不匹配会导致路径解析错误
• 重新创建虚拟环境（指定兼容的Python版本）：

# 替换为对应Python版本的路径
C:/PythonXX/python.exe -m venv C:/wamp/apache2/htdocs/<app.name>/env

4. 修复路径与权限问题 #

• 确保所有路径（虚拟环境、项目目录、静态文件目录）无空格或特殊字符，避免解析异常
• 检查Apache服务运行用户（通常为LocalSystem或自定义用户）对虚拟环境、项目目录拥有读取+执行权限

5. 备选：正确使用activate_this.py（仅当守护进程模式不可用时） #

如果必须手动激活，确保activate_this.py路径正确并执行：

activate_this = 'C:/wamp/apache2/htdocs/<app.name>/env/Scripts/activate_this.py'
exec(open(activate_this).read(), {'__file__': activate_this})

注：若虚拟环境Scripts目录无activate_this.py，可从Python安装目录的site-packages/virtualenv文件夹中复制。

验证步骤 #

1. 重启Apache服务，使配置生效
2. 查看Apache错误日志（${APACHE_LOG_DIR}/error.log），确认无新错误
3. 访问http://my.app.name，验证Django应用是否正常运行

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