pip安装mod_wsgi后配置Apache遇WSGIScriptAlias无效命令问题

这个报错的核心原因是：Apache没有加载你在虚拟环境中通过pip安装的mod_wsgi模块——系统默认的Apache只会识别通过apt包管理器安装的模块，而你自定义安装的模块需要手动配置加载。下面是一步步的解决流程：

1. 获取虚拟环境中mod_wsgi的模块配置 #

先激活你的虚拟环境（或者直接用虚拟环境的绝对路径执行命令），运行以下命令获取模块加载的配置代码：

# 激活虚拟环境
source /usr/local/pulseenv/bin/activate
# 输出模块配置
mod_wsgi-express module-config

执行后会得到类似这样的输出：

LoadModule wsgi_module "/usr/local/pulseenv/lib/python3.5/site-packages/mod_wsgi/server/mod_wsgi-py35.cpython-35m-x86_64-linux-gnu.so"
WSGIPythonHome "/usr/local/pulseenv"

把这两行内容复制下来，后面会用到。

2. 配置Apache加载该mod_wsgi模块 #

需要把上面的配置添加到Apache的模块加载配置中：

• 先检查是否有旧的mod_wsgi模块（通过apt安装的），如果有，先禁用：

  sudo a2dismod wsgi
  

• 创建一个新的模块配置文件：

  sudo nano /etc/apache2/mods-available/wsgi.load
  

• 将第一步复制的两行内容粘贴到这个文件中，保存并退出。
• 启用这个新的mod_wsgi模块：

  sudo a2enmod wsgi
  

3. 修正你的Apache虚拟主机配置 #

打开你的虚拟主机文件/etc/apache2/sites-available/000-default.conf，补充必要的WSGI配置项，确保指向你的虚拟环境和Django项目：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost

    # 指向你的虚拟环境
    WSGIPythonHome /usr/local/pulseenv
    # 替换为你的Django项目根目录（包含manage.py的目录）
    WSGIPythonPath /var/www/your_django_project

    # 映射根路径到Django的wsgi.py文件，替换项目名
    WSGIScriptAlias / /var/www/your_django_project/your_project_name/wsgi.py process-group=your_project_name application-group=%{GLOBAL}

    # 授权Apache访问wsgi.py所在目录
    <Directory /var/www/your_django_project/your_project_name>
        <Files wsgi.py>
            Require all granted
        </Files>
    </Directory>

    # 静态文件配置（如果项目需要）
    Alias /static/ /var/www/your_django_project/static/
    <Directory /var/www/your_django_project/static>
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

注意把上面的/var/www/your_django_project和your_project_name替换成你实际的项目路径和项目名称。

4. 重启Apache并验证 #

完成配置后，重启Apache服务：

sudo systemctl restart apache2

然后可以查看错误日志确认是否还有问题：

tail -f /var/log/apache2/error.log

如果没有报错，访问你的服务器IP应该就能看到Django的页面了。

额外注意事项 #

• 确保Apache的运行用户（默认是www-data）对虚拟环境目录和Django项目目录有读取权限，必要时调整权限：

  sudo chown -R www-data:www-data /usr/local/pulseenv
  sudo chown -R www-data:www-data /var/www/your_django_project
  

• 如果之前通过apt安装过mod_wsgi，最好彻底卸载避免冲突：

  sudo apt remove --purge libapache2-mod-wsgi-py3
  

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