Django AllAuth添加用户UUID字段时遇配置错误求助

问题场景 #

• 为用户注册流程添加UUID字段，配置AUTH_USER_MODEL = "aihuser.UidUser"后，无论是否执行makemigrations均报错，已删除所有迁移文件并重建数据库：
  • 注释AUTH_USER_MODEL配置时，触发反向访问器冲突错误：提示aihuser.AihUser.groups与auth.User.groups等字段的反向访问器重复；
  • 取消注释该配置时，触发RuntimeError：无法解析wagtailcore.ModelLogEntry的user关联关系。

项目环境 #

• Django 4.1.4
• Wagtail 4.1.9
• django-allauth 0.58.2

相关代码 #

自定义用户模型 #

import uuid
from django.db import models
from django.contrib.auth.models import AbstractUser

class AihUser(AbstractUser):
    uuid = models.UUIDField(default=uuid.uuid4, editable=False, unique=True)

注册表单 #

from django import forms
from allauth.account.forms import SignupForm
from .models import *
import uuid

class AihuserSignupForm(SignupForm):
    def save(self, request):
        user = super(AihuserSignupForm, self).save(request)
        user.uuid = uuid.uuid4()
        user.save()
        return user

Settings核心配置 #

INSTALLED_APPS = [
    'wagtail_modeltranslation',
    'wagtail.contrib.forms',
    ...
    'apps.aihuser',
]
AUTHENTICATION_BACKENDS = (
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
)

解决方案 #

1. 修正AUTH_USER_MODEL配置 #

当前配置的模型名与实际自定义模型名不匹配，正确配置应为：

AUTH_USER_MODEL = "aihuser.AihUser"

2. 解决反向访问器冲突 #

冲突根源是Django同时加载默认auth.User和自定义AihUser，两者继承的AbstractUser包含相同关联字段，导致反向访问器重复。处理步骤：

• 彻底清理数据库与迁移文件：
  1. 删除所有app下migrations目录内的文件（保留__init__.py）；
  2. 删除数据库文件（如SQLite的db.sqlite3）或清空数据库；
  3. 执行python manage.py migrate初始化数据库；
• 确保项目启动时仅加载自定义用户模型，不要同时启用默认用户模型的相关引用。

3. 修复Wagtail关联关系错误 #

Wagtail的ModelLogEntry依赖用户模型，若项目初始化后才切换自定义用户模型，会导致关联失效。处理方式：

• 若项目处于初期阶段，重新初始化项目，一开始就配置好AUTH_USER_MODEL；
• 若必须中途修改，执行以下步骤：
  1. 确保AUTH_USER_MODEL配置正确；
  2. 执行python manage.py makemigrations aihuser生成自定义用户模型的迁移；
  3. 执行python manage.py migrate完成迁移，若仍报错，需手动调整Wagtail相关迁移中的用户模型引用（风险较高，不推荐）。

4. 优化UUID生成逻辑 #

自定义模型中已通过default=uuid.uuid4自动生成UUID，无需在注册表单中手动生成，可简化表单代码：

class AihuserSignupForm(SignupForm):
    def save(self, request):
        return super().save(request)

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