在Django电商项目中配置自定义角色遇阻，登录等功能失效求助

我已完成基于Django的电商Web应用开发，现需添加用户角色（admin、staff、merchant、customer）功能，但配置过程中遇到问题：添加CustomUser模型后，登录、登出及注册功能均无法正常工作。以下是项目相关代码详情，恳请协助解决：

现有Customer模型 #

class Customer(models.Model):
    user=models.OneToOneField(User,on_delete=models.CASCADE)
    # user=models.OneToOneField(User,on_delete=models.CASCADE) -change I made to add CustomUser model
    phone=models.CharField(max_length=10)
    city = models.TextField(max_length=30)
    state = models.TextField(max_length=30)

    def __str__(self):
        return self.user.username

拟引入的CustomUser模型 #

class CustomUser(AbstractUser):
    ROLES=(
        ('admin', 'Admin'),
        ('staff', 'Staff'),
        ('merchant', 'Merchant'),
        ('user', 'User'),
    )
    role = models.CharField(max_length=8,choices=ROLES,default='Customer')

    def is_admin(self):
        return self.role == 'admin'

    def is_staff(self):
        return self.role == 'staff'

    def is_merchant(self):
        return self.role == 'merchant'

问题原因及解决步骤 #

1. 修复CustomUser模型的默认值错误

你的ROLES选项中没有'Customer'这个值，对应的可选值是('user', 'User')，但默认值写了'Customer'，这会导致数据库字段验证失败。修改默认值：

role = models.CharField(max_length=8, choices=ROLES, default='user')

2. 更新Customer模型的关联对象

Customer模型当前关联的是Django默认的User模型，需要改为关联自定义的CustomUser：

# 确保先导入CustomUser
from .models import CustomUser

class Customer(models.Model):
    user = models.OneToOneField(CustomUser, on_delete=models.CASCADE)
    phone = models.CharField(max_length=10)
    city = models.TextField(max_length=30)
    state = models.TextField(max_length=30)

    def __str__(self):
        return self.user.username

3. 在settings.py中指定自定义用户模型

这是关键步骤，Django需要明确使用你的自定义用户模型替代默认模型。在项目的settings.py中添加：

AUTH_USER_MODEL = '你的应用名称.CustomUser'

注意：如果项目已经执行过迁移，需要清理旧的迁移文件（应用下migrations文件夹中除__init__.py外的所有文件）并重置数据库（仅适用于开发环境），否则会出现迁移冲突。

4. 适配认证表单（若使用默认登录/注册视图）

Django自带的认证表单默认绑定默认User模型，需要自定义表单适配CustomUser：

from django.contrib.auth.forms import UserCreationForm, AuthenticationForm
from .models import CustomUser

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser
        fields = ('username', 'email', 'role')

class CustomAuthenticationForm(AuthenticationForm):
    class Meta:
        model = CustomUser
        fields = ('username', 'password')

之后在视图或URL配置中指定使用这些自定义表单，比如在注册视图中设置form_class=CustomUserCreationForm。

5. 执行数据库迁移

完成上述修改后，执行迁移命令更新数据库：

python manage.py makemigrations
python manage.py migrate

内容的提问来源于stack exchange，提问作者Navin-AmriSystems