使用pyenv搭配mod_wsgi部署Python Web应用遇内部服务器错误求助

看起来你的WSGI脚本没法被Apache的mod_wsgi正确加载，咱们一步步排查常见原因：

• 先检查脚本本身的语法错误
  直接在服务器上运行这个WSGI脚本，看看有没有语法或者导入错误：

  python /home/user/API/config_files/myservice.wsgi.py
  

  如果有报错，先把这些基础问题解决——比如缩进错误、缺少依赖模块、括号不匹配之类的，这些是最常见的触发这个错误的原因。

• 验证文件和目录权限
  Apache运行时用的是www-data用户（大部分Debian/Ubuntu系统是这样），这个用户必须能读取你的WSGI脚本，并且能访问上级目录（因为要进入到脚本所在的文件夹）。

  • 查看脚本权限：ls -l /home/user/API/config_files/myservice.wsgi.py
  • 给脚本添加读权限：sudo chmod 644 /home/user/API/config_files/myservice.wsgi.py
  • 确保上级目录有执行权限（允许用户进入）：

    sudo chmod +x /home/user/API
    sudo chmod +x /home/user/API/config_files
    

  • 必要时可以把脚本的所有者改成www-data：sudo chown www-data:www-data /home/user/API/config_files/myservice.wsgi.py

• 检查Python版本匹配问题
  你安装的libapache2-mod-wsgi是针对Python 2.x的模块，如果你的Web应用是用Python 3开发的，就会出现版本不兼容的情况。

  • 先查看mod_wsgi对应的Python版本：mod_wsgi-express module-config
  • 如果版本不匹配，卸载旧的mod_wsgi，安装Python3版本：

    sudo apt-get remove libapache2-mod-wsgi
    sudo apt-get install libapache2-mod-wsgi-py3
    sudo a2enmod wsgi
    sudo systemctl restart apache2
    

• 确认Python导入路径配置
  如果你的WSGI脚本需要导入应用目录下的模块，Apache的Python环境可能找不到这些路径。可以在WSGI脚本的最开头添加路径：

  import sys
  # 把你的应用根目录添加到Python路径
  sys.path.insert(0, '/home/user/API')
  

• 检查WSGI应用对象是否正确定义
  mod_wsgi需要脚本里有一个名为application的可调用对象，比如：

  • Flask应用：

    from flask import Flask
    app = Flask(__name__)
    # 必须导出名为application的对象
    application = app
    

  • Django应用：

    import os
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
    from django.core.wsgi import get_wsgi_application
    application = get_wsgi_application()
    

  如果你的脚本里没有这个对象，或者名字写错了（比如写成app而不是application），mod_wsgi就没法识别。

排查完这些点之后，重启Apache：sudo systemctl restart apache2，再试试访问应用。如果还有问题，把日志里的完整报错信息贴出来，能更精准定位。

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