Django扩展用户模型：继承AbstractUser与一对一关联User的对比咨询

一、两种实现方式 #

1. 继承AbstractUser自定义用户模型 #

直接扩展Django提供的抽象用户模型，添加所需字段：

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

class CustomUser(AbstractUser):
    # 示例添加字段
    phone = models.CharField(max_length=11, unique=True, verbose_name="手机号")
    real_name = models.CharField(max_length=30, null=True, blank=True, verbose_name="真实姓名")

配置settings.py指定自定义用户模型（必须在首次执行migrate前配置）：

AUTH_USER_MODEL = "your_app_name.CustomUser"

2. 通过OneToOneField关联扩展模型 #

保留原生User模型，创建独立的扩展模型与用户一对一绑定：

from django.contrib.auth.models import User
from django.db import models

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name="profile")
    phone = models.CharField(max_length=11, unique=True, verbose_name="手机号")
    address = models.TextField(null=True, blank=True, verbose_name="联系地址")

可通过Django信号（如post_save）实现用户创建时自动生成关联的UserProfile实例。

二、方案选择与优劣对比 #

优先选继承AbstractUser的场景 #

当你需要添加的是用户核心身份字段（如手机号、真实姓名、性别，这些字段和用户身份强绑定，业务中频繁使用）：

• 优势：
  • 查询高效：无需额外JOIN操作，一次查询即可获取所有用户信息
  • 逻辑简洁：认证、序列化、表单处理等流程只需操作一个模型，避免多模型同步的麻烦
  • 官方推荐：符合Django认证系统的设计规范，后续扩展更顺畅
• 注意：项目初期就需配置，若已运行一段时间再修改，需迁移原有用户数据，成本较高

优先选OneToOneField关联的场景 #

当你添加的是非核心扩展信息（如用户偏好、个性化设置，业务中不频繁调用），或项目已上线不想改动原有User模型：

• 优势：
  • 无侵入性：完全保留原生User模型，无需修改全局配置
  • 灵活性高：可拆分多个扩展模型（如UserProfile存基础信息、UserSettings存偏好）
  • 改造成本低：适合项目中后期临时添加扩展字段的需求
• 劣势：
  • 查询需JOIN，性能略逊于单模型
  • 操作需处理两个模型，易出现关联实例缺失的情况，需额外做异常处理

官方文档参考 #

Django官方文档的「Customizing authentication in Django」章节详细覆盖了这两种方案：

• 继承AbstractUser属于自定义用户模型的标准方案
• OneToOneField关联属于扩展现有用户模型的补充方案

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