Django移植后runserver报relation "django_migrations"已存在错误如何解决

报错核心原因 #

Django启动时默认会校验迁移表状态，尝试初始化创建django_migrations表，但你提前导入的数据库已经存在该表，触发冲突报错。

排查流程 #

• 确认数据库连接配置正确，检查settings.py中数据库配置指向的库，确实是你提前导入了业务数据的目标库，没有误连空库或者其他测试库。
• 登录PostgreSQL校验django_migrations表状态，执行SQL：

  SELECT COUNT(*) FROM django_migrations;
  

  如果返回值大于0，说明该表已经存储了原有环境的全量迁移记录，不需要重新创建。
• 检查所有App的migrations目录是否完整，是否和原环境的迁移文件一致，避免因为迁移文件缺失导致Django误判需要重新初始化迁移体系。

解决方法 #

情况1：django_migrations表已有全量迁移记录 #

直接执行fake初始化命令，让Django识别现有表的合法性，不需要重新创建：

python manage.py migrate --fake-initial

命令执行完成后再启动runserver即可正常运行。

情况2：django_migrations表存在但数据为空/不完整 #

1. 先全量备份当前数据库的业务数据，避免操作丢失数据
2. 执行SQL删除已存在的空迁移表：

DROP TABLE django_migrations;

3. 执行全量fake迁移，同步生成和原环境一致的迁移记录：

python manage.py migrate --fake

4. 迁移完成后启动服务即可。

特殊兼容处理 #

如果以上操作仍报错，检查Django数据库配置中的SCHEMA参数，确认你导入的表都在配置指定的schema下，默认PostgreSQL的schema为public，如果原环境自定义了schema，需要在新环境的配置中同步指定。

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