Django PostgreSQL迁移报无匹配唯一约束错误

你在models.py中扩展Django内置User模型，定义了Client模型，并添加指向自身的多对多字段用来标记关联客户端，代码如下：

class Client(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    clients = models.ManyToManyField("self", blank=True)

本地使用python manage.py runserver启动的开发环境运行无异常，在测试服务器的PostgreSQL环境执行python manage.py migrate时抛出错误：

psycopg2.errors.InvalidForeignKey: there is no unique constraint matching given keys for referenced table "content_client"

这个问题和数据库的约束校验严格度、环境间表结构不一致直接相关：

• 本地开发环境默认使用SQLite数据库，它对外键约束的校验逻辑非常宽松，即使表结构存在历史遗留的不规范问题，也不会阻断运行；而PostgreSQL严格遵循SQL标准，创建外键时强制要求被引用的字段必须存在唯一约束。
• 出现这个报错的核心原因是测试环境的content_client表是历史错误迁移生成的残留结构：要么是你之前迭代模型时生成过错误的迁移，在测试环境执行后留下了主键缺失唯一约束的content_client表；要么是你本地的迁移文件没有和代码同步提交到测试环境，测试环境执行迁移时用了和本地不一致的迁移逻辑，生成的表结构不符合Django对多对多关联的约束要求。
• 正常情况下Django生成的Client模型默认id主键自带唯一约束，自引用多对多生成的中间表外键关联id字段不会触发这个错误，只有当被引用的表本身结构不对时才会报这个错。

• 先备份测试服务器的现有业务数据，避免操作失误丢数据。
• 回滚测试环境中对应app（即报错里提到的content应用）的所有迁移，执行命令：

  python manage.py migrate content zero
  

  执行完确认数据库里的content_client、content_client_clients（多对多自动生成的中间表）都被正确删除。
• 检查本地代码的迁移文件，确认所有模型变更都已经通过makemigrations生成了合法的迁移文件，没有手动篡改过已提交的迁移记录，将完整的迁移文件同步到测试服务器。
• 重新执行迁移命令即可：

  python manage.py migrate
  

可选优化 #

如果你的客户端关联关系不需要双向对称（比如A标记了关联B，不需要B自动关联A），可以给多对多字段加上symmetrical=False参数，避免后续业务逻辑出现不符合预期的关联，写法如下：

clients = models.ManyToManyField("self", blank=True, symmetrical=False)

所有环境必须使用同一套迁移文件，不要在不同环境单独执行makemigrations生成迁移，也不要随意修改已经提交过的迁移文件，否则很容易出现不同环境表结构不一致的问题。

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