Django基于AbstractUser如何重命名用户模型的first_name、last_name字段

你编写的代码没有实现字段重命名的预期，本质是只在自定义用户模型上新增了两个独立字段，完全没有处理从AbstractUser父类继承来的原生first_name、last_name字段：

• 父类自带的两个姓名字段仍会正常生成对应的数据库列，保留原有逻辑
• 你新定义的firstName、lastName是完全独立的新字段，和父类原生字段没有任何映射关系，自然达不到重命名的效果。

核心实现逻辑：Python模型层的字段重命名，本质是将原有继承字段的Python属性名替换为你想要的camelCase格式，同时通过字段参数绑定原有数据库列，避免生成冗余列、造成数据丢失。

第一步：覆盖替换原有继承字段 #

在自定义User模型中重新定义目标字段，同时把父类遗留的first_name、last_name从模型字段集合中移除，核心代码结构如下：

from django.contrib.auth.models import AbstractUser
from django.core.exceptions import FieldDoesNotExist
from django.db import models

class User(AbstractUser):
    email = models.EmailField('email address', unique=True)
    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['username', 'firstName', 'lastName']

    # 定义重命名后的姓名字段，参数需和父类原生字段完全匹配
    firstName = models.CharField(
        "First Name",
        max_length=150,
        blank=True,
        # 有存量数据的项目必须配置该参数，绑定原有数据库列名，避免生成新空列
        db_column="first_name"
    )
    lastName = models.CharField(
        "Last Name",
        max_length=150,
        blank=True,
        db_column="last_name"
    )

    # 兼容AbstractUser内置方法，避免属性不存在报错
    def get_full_name(self):
        return f"{self.firstName} {self.lastName}".strip()

    def get_short_name(self):
        return self.firstName

# 类定义完成后，移除父类继承的旧字段，避免冗余列生成
_old_fields = ['first_name', 'last_name']
for _field_name in _old_fields:
    try:
        _field = User._meta.get_field(_field_name)
        User._meta.local_fields.remove(_field)
    except FieldDoesNotExist:
        pass

• 如果项目处于初始开发阶段，无存量用户数据、也未生成过用户表迁移文件：
  可以去掉代码中的db_column参数，删除旧的迁移文件、清空数据库中废弃的用户表结构，重新生成迁移并执行即可，新的数据库列名会和Python属性名保持一致。
• 如果项目已经有线上存量用户数据：
  一定要保留db_column参数，此时Python层的firstName、lastName读写的就是数据库里原有的first_name、last_name列，完全不需要额外做数据迁移搬运，零成本切换不会丢失历史数据。

• 不要跳过移除父类旧字段的步骤，否则Django会在数据库里同时生成first_name/last_name和firstName/lastName共4个姓名字段，产生大量冗余空列。
• 不要在有存量数据的场景下省略db_column配置直接替换字段，否则Django会生成迁移把原有存储姓名的旧列删掉，新建两个空的新列，直接清空所有用户的历史姓名数据。
• 新定义的字段参数（max_length、blank、null等）一定要和父类原字段完全一致，不然会出现表单校验规则不匹配的问题——比如原字段允许空白，新定义的字段没加blank=True，就会导致所有用户信息更新接口强制要求填写姓名。

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