如何在Django已创建的内置User模型中直接新增、覆写字段,无需额外建扩展关联模型
直接扩展、覆写Django内置User字段的实现方案
你之前尝试新建独立Client模型、和User做外键/一对一关联的方式,本质是把自定义字段拆分到独立表存储,既没法直接在用户表内部新增、覆写字段,还会带来跨表查询的额外开销,不符合你不创建独立扩展模型的需求。按照Django的官方规范,要实现无额外扩展表直接修改User字段的目标,需要通过自定义用户模型完全替代内置User类的路径实现,具体方法如下:
前置规则提醒
Django对用户模型的配置有强制要求:自定义用户模型的配置,必须在项目第一次执行migrate命令、生成初始数据库迁移文件之前完成。如果项目已经跑完初始迁移、建好了内置的auth_user表,强行直接替换会触发严重的迁移冲突,这种场景下官方更推荐用一对一关联的方式做扩展。
具体实现步骤
- 在项目的
settings.py文件中增加配置,指定自定义用户模型的路径:
# settings.py AUTH_USER_MODEL = "你的自定义用户所在的app名称.User"
- 在对应app的
models.py中编写自定义用户模型,直接内置你需要的扩展字段、覆写原有字段的属性,不需要额外建Client扩展表:
from django.db import models from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin # 自定义用户管理器,替换内置User的默认管理逻辑 class CustomUserManager(BaseUserManager): def create_user(self, email, password=None, **extra_fields): if not email: raise ValueError("用户必须填写邮箱") email = self.normalize_email(email) user = self.model(email=email, **extra_fields) user.set_password(password) user.save(using=self._db) return user def create_superuser(self, email, password=None, **extra_fields): extra_fields.setdefault("is_staff", True) extra_fields.setdefault("is_superuser", True) return self.create_user(email, password, **extra_fields) # 自定义User模型,完全替代内置auth.User class User(AbstractBaseUser, PermissionsMixin): # 你原本写在Client模型中的自定义字段,直接放到这里 cell = models.PositiveIntegerField(blank=False, verbose_name="联系电话") address = models.CharField( default="Sandton, JHB", blank=False, max_length=132, verbose_name="联系地址" ) # 直接覆写内置User的原有字段,自定义属性 email = models.EmailField(unique=True, verbose_name="登录邮箱") username = models.CharField(max_length=50, blank=True, verbose_name="用户名") is_staff = models.BooleanField(default=False, verbose_name="是否为员工账号") is_active = models.BooleanField(default=True, verbose_name="账号是否启用") # 绑定自定义管理器 objects = CustomUserManager() # 指定登录使用的字段,替代内置的username字段 USERNAME_FIELD = "email" # 创建超级管理员时需要额外录入的字段 REQUIRED_FIELDS = ["cell", "address"]
后续使用注意事项
- 自定义用户模型配置完成后,所有代码中涉及用户表的外键关联,都要通过
settings.AUTH_USER_MODEL引用模型,不要直接导入django.contrib.auth.models.User,否则会触发模型循环引用错误。 - 这种实现方式下,所有自定义字段、覆写后的字段都会直接存储在用户表中,不需要关联其他扩展表,查询时不需要跨表拼接,完全满足你不创建独立扩展模型的需求。
内容的提问来源于stack exchange,提问作者Randall Buckton
相关产品推荐
相关产品推荐

