Django自定义AbstractBaseUser迁移报错：users表已存在

问题根源 #

你的Users模型Meta类中设置了managed = True，Django会尝试自动创建users表，但数据库中该表已存在，因此执行migrate时触发"表已存在"的错误。

分步解决方案 #

1. 生成初始迁移记录并标记为已完成 #

• 临时修改模型的Meta配置，让Django不管理表的创建：

  class Meta:
      managed = False
      db_table = 'users'
  

• 执行命令生成迁移文件：

  python manage.py makemigrations
  

• 标记该迁移已应用（跳过实际创建表的操作）：

  python manage.py migrate --fake [你的应用名称]
  

  替换[你的应用名称]为对应app的名字，这一步会让Django认为初始表结构迁移已经完成。

2. 恢复表管理权限并添加新字段 #

• 将模型Meta改回managed = True，让Django可以管理后续的字段变更：

  class Meta:
      managed = True
      db_table = 'users'
  

• 在Users模型中添加你需要新增的字段。

3. 执行新增字段的迁移 #

• 生成针对新字段的迁移文件：

  python manage.py makemigrations
  

• 执行迁移，此时Django只会处理新增字段，不会再尝试创建已存在的users表：

  python manage.py migrate
  

额外优化建议 #

• UserManager中用到的normalize_email未导入，需在顶部添加：

  from django.utils.html import normalize_email
  

• date_registered的default设置有误，直接调用actual_epoch_time()会导致项目启动时就固定一个时间，应改为传递函数本身：

  date_registered = models.IntegerField(default=actual_epoch_time)
  

• 自定义的set_password和check_password要确保与遗留数据库的加密逻辑完全一致，避免用户登录验证失败。

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