Django用户模型定制指南：从基础到高级实践-代码聚汇网

Django用户模型定制指南：从基础到高级实践

Nan Chiang·2026-08-23·阅读 22 GEO检测（免费）

Django用户模型AbstractUser

|难度：普通|阅读约 16 分钟

1. 为什么需要替换Django默认用户表

Django框架自带的User模型虽然开箱即用，但在实际项目中往往成为第一个需要定制的组件。默认的auth_user表结构简单到几乎无法满足任何真实业务需求——它只包含username、password、email等基础字段，缺少手机号、头像、性别等现代应用必备字段。

更关键的是，直接修改默认User模型是Django官方明确禁止的操作。我在早期项目中曾尝试用South迁移工具直接修改auth_user表结构，结果导致整个用户系统崩溃。这种暴力破解方式会破坏Django内置的认证系统，还会在团队协作时引发数据库同步灾难。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 三种用户模型扩展方案对比

2.1 方案一：继承AbstractUser（推荐）

这是最平衡的扩展方式，适合90%的项目场景。通过继承django.contrib.auth.models.AbstractUser，可以保留所有默认认证逻辑，同时添加自定义字段：

python复制# models.py
from django.contrib.auth.models import AbstractUser

class CustomUser(AbstractUser):
    mobile = models.CharField(max_length=15, unique=True)
    avatar = models.ImageField(upload_to='avatars/')
    gender = models.CharField(max_length=10, choices=[('M','Male'),('F','Female')])
    
# settings.py
AUTH_USER_MODEL = 'your_app.CustomUser'

关键点：

必须在首次迁移前设置AUTH_USER_MODEL
所有外键引用用户模型时要用settings.AUTH_USER_MODEL而非直接引用
保留原生的权限系统、组管理等功能

2.2 方案二：继承AbstractBaseUser（高级）

当需要完全重新设计认证逻辑时使用。我曾在一个需要手机号+验证码登录的项目中使用此方案：

python复制class MobileUser(AbstractBaseUser, PermissionsMixin):
    mobile = models.CharField(max_length=15, unique=True)
    is_active = models.BooleanField(default=False)
    
    USERNAME_FIELD = 'mobile'
    REQUIRED_FIELDS = []
    
    objects = MobileUserManager()

需要额外实现：

自定义UserManager处理create_user/create_superuser
重写认证后端（如支持验证码登录）
手动处理权限系统集成

2.3 方案三：一对一关联Profile（不推荐）

早期Django社区流行的方案，通过单独建立Profile表关联默认User：

python复制class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    mobile = models.CharField(max_length=15)

这种方案的问题在于：

查询效率低（需要JOIN操作）
无法在admin中统一管理
仍然依赖默认User表结构

3. 实战迁移操作指南

3.1 项目初始化阶段

如果是全新项目，直接在第一次迁移前修改AUTH_USER_MODEL：

创建users应用：python manage.py startapp users
在users/models.py定义CustomUser

修改settings.py：

python复制INSTALLED_APPS = [
    'users.apps.UsersConfig',
    #...
]
AUTH_USER_MODEL = 'users.CustomUser'

生成迁移文件：python manage.py makemigrations
执行迁移：python manage.py migrate

3.2 已有项目迁移方案

对于已存在数据库的项目，需要更谨慎的操作：

备份完整数据库
创建自定义用户模型（继承AbstractUser）
生成初始迁移文件但不应用

使用以下命令生成数据迁移脚本：

bash复制python manage.py makemigrations --empty --name users_customuser your_app

手动编写数据迁移逻辑：

python复制def forwards_func(apps, schema_editor):
    User = apps.get_model('auth', 'User')
    CustomUser = apps.get_model('users', 'CustomUser')
    
    for user in User.objects.all():
        CustomUser.objects.create(
            id=user.id,
            username=user.username,
            # 其他字段映射...
        )

4. 深度踩坑实录

4.1 第三方包兼容性问题

在集成django-allauth时，由于未及时更新AUTHENTICATION_BACKENDS配置，导致社交登录功能失效。解决方案：

python复制# settings.py
ACCOUNT_USER_MODEL_USERNAME_FIELD = None  # 当使用邮箱/手机作为用户名时需要
AUTHENTICATION_BACKENDS = (
    "allauth.account.auth_backends.AuthenticationBackend",
    "django.contrib.auth.backends.ModelBackend",
)

4.2 Admin后台配置陷阱

自定义用户模型后，admin界面需要特殊处理：

python复制# admin.py
from django.contrib.auth.admin import UserAdmin

class CustomUserAdmin(UserAdmin):
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('个人信息', {'fields': ('mobile', 'avatar')}),
    )
    
admin.site.register(CustomUser, CustomUserAdmin)

4.3 测试用例调整

原有基于默认User的测试用例会失败，需要修改：

python复制from django.test import TestCase
from django.contrib.auth import get_user_model

User = get_user_model()

class AuthTests(TestCase):
    def test_create_user(self):
        user = User.objects.create_user(
            username='test',
            mobile='13800138000',
            password='test123'
        )
        self.assertEqual(user.mobile, '13800138000')

5. 性能优化建议

5.1 查询优化

避免使用user.profile.xxx这种链式查询，改为：

python复制# 错误做法
users = User.objects.filter(profile__gender='M')

# 正确做法 - 使用select_related
users = User.objects.select_related('profile').filter(profile__gender='M')

5.2 信号处理器优化

用户创建后自动初始化配置的推荐方式：

python复制@receiver(post_save, sender=CustomUser)
def init_user_profile(sender, instance, created, **kwargs):
    if created:
        UserConfig.objects.create(user=instance, theme='light')

5.3 缓存策略

频繁访问的用户信息建议缓存：

python复制from django.core.cache import cache

def get_user_with_cache(user_id):
    cache_key = f'user_{user_id}'
    user = cache.get(cache_key)
    if not user:
        user = CustomUser.objects.get(pk=user_id)
        cache.set(cache_key, user, timeout=300)
    return user

6. 企业级实践方案

在大型分布式系统中，我推荐采用以下架构：

用户服务独立化：将用户系统拆分为单独微服务
JWT认证：使用djangorestframework-simplejwt实现无状态认证

读写分离：

python复制class CustomUserRouter:
    def db_for_read(self, model, **hints):
        if model == CustomUser:
            return 'replica'
        return None

审计日志：使用django-auditlog记录关键操作
分库分表：当用户量超过千万时，按用户ID哈希分片

7. 安全加固措施

7.1 密码策略

python复制# settings.py
AUTH_PASSWORD_VALIDATORS = [
    {
        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
        'OPTIONS': {
            'min_length': 10,
        }
    },
]

7.2 登录防护

集成django-axes实现自动封禁：

python复制AXES_FAILURE_LIMIT = 5
AXES_COOLOFF_TIME = timedelta(minutes=30)

7.3 二步验证

使用django-otp增加短信/邮箱验证：

python复制INSTALLED_APPS += ['otp_twilio']
OTP_TWILIO_ACCOUNT = 'your_account_sid'
OTP_TWILIO_AUTH = 'your_auth_token'