如何修复Apache+Django的500错误：未配置指定WSGI守护进程

错误分析 #

报错 No WSGI daemon process called "..." has been configured 说明Apache无法找到你在WSGIProcessGroup中指定的守护进程实例，常见原因包括配置顺序错误、路径无效、名称不匹配或权限问题。

针对你的配置的解决方案 #

• 修正路径笔误：你的CustomLog路径写成了 /home/PROJECT/PROJECT/site/logs/access.log，应与ErrorLog保持一致，改为 /home/USER/PROJECT/site/logs/access.log。路径错误可能导致日志写入失败，进而触发服务异常。

• 调整WSGI指令顺序：建议将WSGI相关配置放在静态资源别名之前，确保守护进程先被初始化：

  <VirtualHost *:80>
          ServerAdmin ADMIN
          ServerName DOMAIN   
  
          ErrorLog /home/USER/PROJECT/site/logs/error.log
          CustomLog /home/USER/PROJECT/site/logs/access.log combined
  
          # 先定义WSGI守护进程
          WSGIDaemonProcess PROJECT python-path=/home/USER/PROJECT/ python-home=/home/USER/PROJECT/VIRTUALENV
          WSGIProcessGroup PROJECT
          WSGIScriptAlias / /home/USER/PROJECT/src/social/wsgi.py
  
          # 再配置静态资源
          Alias /static /home/USER/PROJECT/static
          <Directory /home/USER/PROJECT/static>
                  Require all granted
          </Directory>
  
          <Directory /home/USER/PROJECT/src/social>
                  <Files wsgi.py>
                          Require all granted
                  </Files>
          </Directory>
  </VirtualHost>
  

• 验证路径与权限：

  • 确认python-home指向的虚拟环境目录 /home/USER/PROJECT/VIRTUALENV 真实存在，且包含完整的Python环境。
  • 确认python-path指向的项目根目录 /home/USER/PROJECT/ 正确，Apache运行用户（通常为www-data）对该目录及子目录有读取权限。
  • 检查wsgi.py文件权限，确保Apache用户能读取该文件。

• 强制重启Apache：修改配置后执行以下命令重启服务，确保配置生效：

  # Ubuntu/Debian系统
  sudo systemctl restart apache2
  
  # CentOS/RHEL系统
  sudo service httpd restart
  

额外排查点 #

如果以上操作仍未解决问题，可尝试：

• 检查Apache全局配置中是否有重复的WSGIDaemonProcess定义，避免名称冲突。
• 启用mod_wsgi的调试日志，添加 WSGILogLevel info 到VirtualHost配置中，获取更详细的错误信息。

内容的提问来源于stack exchange，提问作者dark-sqirrel