不能直接继承AbstractUser改username字段,因已有auth_user表含非空约束;必须新建继承AbstractBaseUser+PermissionsMixin的模型,在首次migrate前配置AUTH_USER_MODEL,并手写数据迁移脚本映射旧用户。

为什么不能直接继承 AbstractUser 后改 username 字段?
很多开发者一上来就重写 AbstractUser,把 username 改成 None 或设为 blank=True,结果迁移时爆 NOT NULL constraint failed: auth_user.username。这不是模型定义问题,而是 Django 的 auth.User 表已存在且含非空 username 数据——你没法靠改抽象基类绕过已有数据库约束。
真正可行的路径只有一条:新建自定义用户模型(继承 AbstractBaseUser + PermissionsMixin),并在迁移中手动将旧数据映射过去。
- 必须在项目 首次 migrate 前 就定义好
AUTH_USER_MODEL,否则后续无法生效 - 如果项目已有生产数据,
makemigrations会生成两个迁移文件:一个建新表,一个数据迁移(需手写) -
AbstractBaseUser不带first_name/last_name/email等字段,得自己显式声明,否则迁移会报FieldDoesNotExist
如何写安全的数据迁移脚本把老用户导入新模型?
不能依赖 RunPython 里直接调 User.objects.all(),因为此时新旧模型可能同时注册,Django 会混淆 manager;也不能用 raw SQL 硬插,容易漏掉密码哈希、is_active 状态等细节。
正确做法是:在迁移文件中用 apps.get_model('auth', 'User') 获取原始模型,再逐条构造新用户对象并调 set_password()。
立即学习“Python免费学习笔记(深入)”;
def migrate_users(apps, schema_editor):
OldUser = apps.get_model('auth', 'User')
NewUser = apps.get_model('myapp', 'CustomUser')
for old in OldUser.objects.all():
NewUser.objects.create(
id=old.id,
email=old.email,
phone=old.email.split('@')[0] if '@' in old.email else '', # 示例字段映射
is_staff=old.is_staff,
is_superuser=old.is_superuser,
is_active=old.is_active,
date_joined=old.date_joined,
last_login=old.last_login,
).set_password(old.password) # 复用原哈希值,不重新加密
- 务必保留
id字段一致,否则外键关联(如ForeignKey(User))全断 - 不要调
save(),用create()避免触发信号或自定义save逻辑 -
set_password(old.password)是关键:直接存原哈希串,不是明文,否则所有用户密码失效
迁移后如何让 admin 和登录视图自动适配新模型?
Django admin 默认只认 auth.User,登录视图(django.contrib.auth.views.LoginView)也硬编码了用户查找逻辑。不改配置就会出现「登录页提交无反应」或「admin 列表空」。
两处必须同步更新:
- 在
settings.py中确认AUTH_USER_MODEL = 'myapp.CustomUser'已设置,且myapp在INSTALLED_APPS中靠前 - 自定义 admin:新建
myapp/admin.py,继承UserAdmin并注册,不要 再 importfrom django.contrib.auth.admin import UserAdmin,而要用from django.contrib.auth.admin import UserAdmin as BaseUserAdmin,然后重写list_display、fieldsets以匹配你的字段 - 登录视图无需重写,但模板中
{{ user.username }}要改成{{ user.email }}或其他你暴露的字段
历史外键关系怎么不崩?
假设你有 Article.author = ForeignKey(User),迁移后这个外键仍指向 auth_user.id,但新用户表叫 myapp_customuser,ID 虽一致,Django 查询时却找不到对应对象——因为 ORM 不知道该去哪张表查。
解决方案只有两个,且必须二选一:
- 在迁移前,把所有
ForeignKey(User)改成ForeignKey(settings.AUTH_USER_MODEL),再跑makemigrations。这是推荐做法,一劳永逸 - 若已上线且无法改代码,可在迁移中用 raw SQL 手动更新外键字段的
ON DELETE和引用表名(不推荐,易出错)
最容易被忽略的是第三方包(如 django-taggit、django-comments)里的用户外键——它们不会自动适配 AUTH_USER_MODEL,得查文档看是否支持,不支持就得 fork 或换包。


















