执行Django migrate命令出现外键不匹配错误，求解决方案

执行python manage.py migrate时触发错误：

Django----sqlite3.OperationalError: foreign key mismatch - "socialnetworkapp_chat" referencing "socialnetworkapp_chatroom"

已尝试回滚至之前运行正常的迁移版本，但修改模型后错误反复出现；即使删除相关模型，错误仍持续存在。

相关models.py代码：

class ChatRoom(models.Model):
    chatroom_id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=255)
    created_date = models.DateField(auto_now_add=True)
    created_time = models.TimeField(auto_now_add=True)

class Chat(models.Model):
    chat_id = models.AutoField(primary_key=True)
    chat_content = models.TextField(null=True, blank=True)
    created_date = models.DateField(auto_now_add=True)
    created_time = models.TimeField(auto_now_add=True)
    chatroom = models.ForeignKey(ChatRoom, on_delete=models.CASCADE)
    uid = models.ForeignKey(User, on_delete=models.CASCADE)

排查与解决方法 #

• 清理冲突的迁移文件
  回滚后修改模型生成的新迁移可能存在逻辑冲突：

  1. 查看socialnetworkapp/migrations/目录下的迁移文件，删除和Chat、ChatRoom相关的重复或矛盾迁移。
  2. 备份数据库后，清空django_migrations表中属于socialnetworkapp的记录，删除迁移目录下除__init__.py外的所有文件，重新执行python manage.py makemigrations和python manage.py migrate。

• 验证SQLite外键约束匹配性
  SQLite对外键关联要求严格，需确保：

  • socialnetworkapp_chatroom表的chatroom_id是主键，且socialnetworkapp_chat表的chatroom_id字段类型与它完全一致（均为整数型）。
    可用SQLite工具执行以下语句检查：

  PRAGMA foreign_key_list(socialnetworkapp_chat);
  PRAGMA table_info(socialnetworkapp_chatroom);
  

• 删除数据库残留表结构
  删除models.py中的模型后，数据库可能仍保留旧表，导致迁移时触发外键检查。直接执行SQL删除表：

  DROP TABLE IF EXISTS socialnetworkapp_chat;
  DROP TABLE IF EXISTS socialnetworkapp_chatroom;
  

  完成后重新执行迁移。

• 检查User模型关联
  确认Chat模型的uid外键字段类型，与User模型的主键类型完全匹配，且数据库中User表的主键正常存在。

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