执行Django migrate命令报错提示已存在django_content_type对象如何解决

报错翻译：[Microsoft][SQL Server ODBC 驱动17][SQL Server] 数据库中已存在名为'django_content_type'的对象

报错原因 #

该错误出现的核心原因是目标SQL Server数据库中已经存在django_content_type内置表，Django执行迁移时默认会尝试首次创建该表，表已存在就会触发冲突。常见触发场景包括：

• 之前执行迁移操作中途中断，遗留了已创建的内置表
• 当前数据库曾用于其他Django项目，留存了旧的Django内置表结构
• 手动建表时误创建了同名表

解决方案 #

根据你的数据库数据情况选择对应方案即可：

方案1：数据库无有效业务数据（首次部署场景） #

直接清空所有Django生成的内置表后重新执行迁移：

1. 删除数据库中所有Django相关的内置表，包括django_content_type、django_migrations、所有auth_开头、admin_开头、sessions_开头的表
2. 重新执行迁移命令：
   python manage.py migrate

方案2：数据库已有有效业务数据（不可清空表场景） #

使用伪迁移跳过已存在表的创建步骤：

1. 先执行contenttypes内置应用的伪迁移，标记该应用的迁移已完成，不会实际执行建表操作：
   python manage.py migrate --fake contenttypes
2. 再执行全量迁移：
   python manage.py migrate

提示：如果执行后还出现其他内置表的同名冲突，可以对应补充执行对应应用的伪迁移，比如python manage.py migrate --fake auth、python manage.py migrate --fake admin

方案3：迁移记录完全混乱场景 #

如果本地迁移文件和数据库中存储的迁移记录完全不匹配，可按如下步骤重置迁移逻辑：

1. 删除所有自定义app的migrations目录下除__init__.py外的所有迁移文件
2. 删除数据库中django_migrations表的所有记录
3. 重新生成迁移文件并执行带初始伪迁移标记的命令：

python manage.py makemigrations
python manage.py migrate --fake-initial

--fake-initial参数会自动检测迁移要创建的表是否已存在，已存在的表会自动标记该步迁移完成，不会实际执行建表操作。 #

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