Django启动时django-allauth的AssertionError问题（ACCOUNT_EMAIL_VERIFICATION设为mandatory）

问题描述 #

启动Django开发服务器时，仅当配置项ACCOUNT_EMAIL_VERIFICATION设置为'mandatory'时会触发django-allauth配置校验环节的AssertionError，设置为'none'时项目可正常运行。已尝试重装django-allauth、检查依赖及核对配置，均未解决问题。

错误回溯 #

Traceback (most recent call last):
  File "C:\Users\User\AppData\Local\Programs\Python\Python38-32\lib\threading.py", line 932, in _bootstrap_inner
    self.run()
  File "C:\Users\User\AppData\Local\Programs\Python\Python38-32\lib\threading.py", line 870, in run
    self._target(*self._args, **self._kwargs)
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\utils\autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\core\management\commands\runserver.py", line 125, in inner_run
    autoreload.raise_last_exception()
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\utils\autoreload.py", line 87, in raise_last_exception
    raise _exception[1]
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\core\management\__init__.py", line 398, in execute
    autoreload.check_errors(django.setup)()
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\utils\autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\apps\registry.py", line 116, in populate
    app_config.import_models()
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\django\apps\config.py", line 269, in import_models
    self.models_module = import_module(models_module_name)
  File "C:\Users\User\AppData\Local\Programs\Python\Python38-32\lib\importlib\__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "C:\Users\User\AppData\Local\Programs\Python\Python38-32\lib\importlib\__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1014, in _gcd_import
  File "<frozen importlib._bootstrap>", line 991, in _find_and_load
  File "<frozen importlib._bootstrap>", line 975, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 783, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\allauth\account\models.py", line 9, in <module>
    from . import app_settings, signals
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\allauth\account\app_settings.py", line 373, in <module>
    app_settings = AppSettings("ACCOUNT_")
  File "C:\Users\User\Desktop\Main_project\venv\lib\site-packages\allauth\account\app_settings.py", line 27, in __init__
    assert (
AssertionError

解决方案 #

• 补全邮件发送配置：mandatory模式要求django-allauth能够发送验证邮件，必须在settings.py中配置有效的邮件后端。
  开发环境可以先用控制台后端快速测试：

  EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
  

  生产环境则配置真实SMTP参数：

  EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
  EMAIL_HOST = 'smtp.example.com'
  EMAIL_PORT = 587
  EMAIL_USE_TLS = True
  EMAIL_HOST_USER = 'your-email@example.com'
  EMAIL_HOST_PASSWORD = 'your-email-password-or-app-code'
  DEFAULT_FROM_EMAIL = EMAIL_HOST_USER
  

• 确保ACCOUNT_EMAIL_REQUIRED为True：mandatory模式依赖邮箱必填，添加或确认以下配置：

  ACCOUNT_EMAIL_REQUIRED = True
  

• 升级django-allauth版本：旧版本可能存在配置校验的兼容性问题，执行命令升级到最新稳定版：

  pip install --upgrade django-allauth
  

• 查看断言具体校验条件：直接打开报错文件venv/lib/site-packages/allauth/account/app_settings.py，定位到第27行的assert语句，查看它校验的具体条件（比如是否检查邮件后端配置、是否要求ACCOUNT_EMAIL_REQUIRED），针对性修复缺失的配置。

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