Django迁移报错Colaborador的email字段与基类User冲突但类中无该字段

开发者阿泽

2026-8-27

报错原因

这个冲突是Django模型字段校验机制触发的：

你使用多表继承方式扩展Django内置User模型，父类User继承自AbstractUser，本身已经内置定义了email字段。
你当前贴出的Colaborador代码里确实没有定义email字段，但对应app下migrations目录中的历史迁移文件存在残留记录：之前生成迁移时Colaborador曾经被添加过自有email字段，后续你删除代码里的字段定义后，没有同步清理或修正迁移记录。执行迁移时Django会同时加载当前模型定义和历史迁移的字段结构，父类继承来的email和历史记录里Colaborador的本地email字段重名，直接抛出冲突错误。
极低概率是第三方插件、项目自定义的模型注入逻辑给Colaborador动态加了email字段，绝大多数场景都是历史迁移残留导致。

解决方法

按操作成本从低到高选择：

方案1：清理开发环境的错误迁移（适合开发阶段、无重要线上/本地数据的场景）
1. 进入Colaborador所属app的migrations文件夹，保留__init__.py，删除其余所有迁移文件
2. 如果本地开发库没有需要保留的测试数据，直接删除本地数据库文件（比如默认的db.sqlite3）
3. 重新执行迁移生成与应用命令：
```
python manage.py makemigrations
python manage.py migrate
```
执行完后冲突会直接消失。
方案2：定向修复迁移记录（适合需要保留历史迁移、不想删库的场景）
按文件名的时间顺序依次打开migrations下的文件，搜索给Colaborador模型添加email字段的migrations.AddField操作块，删除该段错误记录后保存，再重新执行migrate命令即可。

方案3：替换为更稳妥的用户扩展方式（避免后续同类问题）
Django官方不推荐直接继承User类做多表继承扩展用户属性，更稳定的写法是通过一对一外键关联内置User模型，参考代码：

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

class Colaborador(models.Model):
    user = models.OneToOneField(
        User,
        on_delete=models.CASCADE,
        related_name="colaborador_profile"
    )
    nome = models.CharField(max_length=100)
    ddd = models.CharField(max_length=2, verbose_name='DDD')
    telefone = models.CharField(max_length=9)
    administrador_sistema = models.BooleanField(default=False)

    class Meta:
        ordering = ['nome']

    def get_absolute_url(self):
        return reverse('colaborador-detail', args=[str(self.id)])

    def __str__(self):
        return self.nome

如果项目还未正式上线，也可以通过自定义AUTH_USER_MODEL的方式替换默认用户模型，从根源上避免继承字段冲突。

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