AWS环境下通过mod_wsgi部署Django应用失败报错求助

嘿，我之前在AWS Elastic Beanstalk部署Django时也踩过类似的坑，给你几个针对性的排查方向，应该能帮你定位问题：

1. 先确认Python版本是否对齐 #

本地运行正常但部署报错，最常见的原因就是EB环境的Python版本和本地不一致。比如你本地用Python 3.10，EB可能默认给你用3.8，导致依赖包不兼容。

• 解决方法：在项目根目录创建.ebextensions/python.config文件，强制指定Python版本：

  option_settings:
    aws:elasticbeanstalk:container:python:
      PythonVersion: 3.10.12  # 替换成你本地用的版本
  

• 同时检查requirements.txt里的包版本，比如Django 4.2需要Python 3.8+，别出现版本不兼容的情况。

2. 核对WSGI脚本路径是否匹配项目结构 #

报错里明确说/opt/python/current/app/diamond/wsgi.py无法加载，你得确认部署后的项目结构是否和这个路径对应：

• 本地项目根目录应该有一个叫diamond的文件夹（就是你Django项目的根目录，里面包含wsgi.py）。
• 检查.ebextensions/django.config里的WSGI路径配置是否正确：

  option_settings:
    aws:elasticbeanstalk:container:python:
      WSGIPath: diamond/wsgi.py  # 和报错里的路径要对应
  

• 如果你的项目还有外层嵌套文件夹，比如my_project/diamond/wsgi.py，那WSGIPath要写成my_project/diamond/wsgi.py。

3. 排查依赖安装是否完整 #

有时候EB在安装依赖时会因为网络或依赖冲突失败，导致WSGI脚本找不到需要的模块：

• 去EB控制台下载完整日志（在“日志”选项里选“请求日志”->“完整日志”），搜索pip install相关的错误，看看有没有包安装失败。
• 本地生成requirements.txt时，别把开发依赖（比如pytest、django-debug-toolbar）加进去，可以用pip freeze --exclude-editable > requirements.txt来生成更干净的依赖列表。

4. 深挖populate() isn't reentrant的根源 #

这个错误通常是Django初始化时的循环导入，或者settings.py里有提前触发Django初始化的代码（比如直接调用模型方法）：

• 你可以给wsgi.py加一段调试代码，把详细错误输出到日志里：

  import traceback
  import os
  
  from django.core.wsgi import get_wsgi_application
  
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'diamond.settings')
  
  try:
      application = get_wsgi_application()
  except Exception as e:
      # 把错误写入临时文件，方便排查
      with open('/tmp/wsgi_error.log', 'w') as f:
          f.write(f"Error Message: {str(e)}\n")
          f.write("Full Traceback:\n")
          f.write(traceback.format_exc())
      raise
  

• 部署后通过EB的SSH连接到实例，查看/tmp/wsgi_error.log，里面的堆栈信息会告诉你具体是哪行代码出了问题。

5. 检查静态文件配置是否正确 #

虽然报错是WSGI加载失败，但静态文件配置错误也可能间接导致初始化失败：

• 确保settings.py里的静态文件配置正确：

  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  STATIC_URL = '/static/'
  

• 同时在.ebextensions/django.config里添加收集静态文件的命令：

  container_commands:
    01_collectstatic:
      command: "python manage.py collectstatic --noinput"
  

• 如果收集静态文件时出现权限或文件缺失问题，也会导致部署失败，进而影响WSGI脚本的加载。

如果以上方法都不行，一定要去看EB实例里的/var/log/httpd/error_log日志，里面会有更具体的加载失败原因，比如某个模块找不到、权限不足或者语法错误。

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