Jelastic云部署Django应用遇RuntimeError: populate() isn't reentrant错误

在Jelastic云部署Django应用时触发RuntimeError: populate() isn't reentrant错误，无法修改django/apps/registry.py排查细节，项目可通过manage.py正常运行。

项目结构 #

Webroot
  |_venv
  |_ROOT
    |_wsgi.py
    |_requirements.txt
    |_monprojet
       |_monapplication
         |_ ...
       |_manage.py
       |_monprojet
         |_settings.py
         |_ ...

错误日志 #

[Thu Sep 08 18:53:08.292973 2022] [wsgi:error] [pid 19457] [remote 10.*:20006] mod_wsgi (pid=19457): Failed to exec Python script file '/var/www/webroot/ROOT/wsgi.py'.
[Thu Sep 08 18:53:08.293121 2022] [wsgi:error] [pid 19457] [remote 10.*:20006] mod_wsgi (pid=19457): Exception occurred processing WSGI script '/var/www/webroot/ROOT/wsgi.py'.
[Thu Sep 08 18:53:08.293885 2022] [wsgi:error] [pid 19457] [remote 10.*:20006] Traceback (most recent call last):
[Thu Sep 08 18:53:08.294049 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]   File "/var/www/webroot/ROOT/wsgi.py", line 15, in <module>
[Thu Sep 08 18:53:08.294083 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]     application = get_wsgi_application()
[Thu Sep 08 18:53:08.294136 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]   File "/opt/jelastic-python310/lib/python3.10/site-packages/django/core/wsgi.py", line 12, in get_wsgi_application
[Thu Sep 08 18:53:08.294169 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]     django.setup(set_prefix=False)
[Thu Sep 08 18:53:08.294254 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]   File "/opt/jelastic-python310/lib/python3.10/site-packages/django/__init__.py", line 24, in setup
[Thu Sep 08 18:53:08.294281 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]     apps.populate(settings.INSTALLED_APPS)
[Thu Sep 08 18:53:08.294415 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]   File "/opt/jelastic-python310/lib/python3.10/site-packages/django/apps/registry.py", line 83, in populate
[Thu Sep 08 18:53:08.294490 2022] [wsgi:error] [pid 19457] [remote 10.*:20006]     raise RuntimeError("populate() isn't reentrant")
[Thu Sep 08 18:53:08.294790 2022] [wsgi:error] [pid 19457] [remote 10.*:20006] RuntimeError: populate() isn't reentrant

WSGI.py 文件内容 #

virtenv = os.path.expanduser('~') + '/venv/'
virtualenv = os.path.join(virtenv, 'bin/activate_this.py')
try:
    if sys.version.split(' ')[0].split('.')[0] == '3':
        exec(compile(open(virtualenv, "rb").read(), virtualenv, 'exec'), dict(__file__=virtualenv))
    else:
        execfile(virtualenv, dict(__file__=virtualenv))
except IOError:
    pass
sys.path.append(os.path.expanduser('~'))
sys.path.append(os.path.expanduser('~') + '/ROOT/')
os.environ['DJANGO_SETTINGS_MODULE'] = 'ROOT.monprojet.monprojet.settings'
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

settings.py 片段 #

# Build paths inside the project like this: BASE_DIR / 'subdir'.
BASE_DIR = Path(__file__).resolve().parent.parent

ALLOWED_HOSTS = ['*']


# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'monapplication',
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'monprojet.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

WSGI_APPLICATION = 'ROOT.wsgi.application'

解决方案 #

这个错误通常是Django应用初始化时出现异常，导致populate()被重复调用触发的。结合你的部署环境和配置，按以下步骤排查修复：

• 修正WSGI路径与配置
  调整WSGI文件中的路径逻辑，避免模块查找混乱：

  import os
  import sys
  
  # 指向Django项目根目录（包含manage.py的目录）
  PROJECT_ROOT = os.path.join(os.path.expanduser('~'), 'ROOT', 'monprojet')
  sys.path.insert(0, PROJECT_ROOT)
  # 优先加载虚拟环境的依赖
  sys.path.insert(0, os.path.join(os.path.expanduser('~'), 'venv', 'lib', 'python3.10', 'site-packages'))
  
  # 直接指向项目内的settings模块，无需ROOT前缀
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'monprojet.settings')
  
  from django.core.wsgi import get_wsgi_application
  application = get_wsgi_application()
  

• 修正Settings配置
  将WSGI_APPLICATION改为'monprojet.wsgi.application'，同时把ROOT目录下的wsgi.py替换为Django项目自带的monprojet/monprojet/wsgi.py文件；检查monapplication目录下是否存在__init__.py，确保应用能被正确识别。

• 验证虚拟环境与依赖
  登录Jelastic节点，激活虚拟环境后执行pip list确认依赖版本与本地一致；运行python manage.py check排查项目配置语法错误或缺失依赖。

• 调整mod_wsgi环境
  在Jelastic环境设置中指定使用虚拟环境的Python版本，而非系统默认版本；重启应用节点使配置生效。

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