Django2.2.7与PostgreSQL12执行migrate报错：关联表无匹配唯一约束

核心原因 #

虽然你在Clients模型的name字段上设置了unique=True，但数据库中的clients_clients表实际上并没有为name字段创建唯一约束，导致PostgreSQL拒绝创建指向该字段的外键关联。

这种情况通常由以下几种原因导致：

• 最初定义Clients模型时name字段没有unique=True，后续添加该属性后，生成的迁移文件未正确执行，或执行过程中出错
• 手动修改过数据库表结构，误删除了name字段的唯一约束
• Django迁移历史出现不一致，模型定义与数据库实际结构脱节

排查与解决步骤 #

1. 验证数据库约束是否存在 #

先通过PostgreSQL命令确认clients_clients表的name字段是否真的有唯一约束：

SELECT conname 
FROM pg_constraint 
WHERE conrelid = 'clients_clients'::regclass 
  AND conkey = ARRAY[(SELECT attnum FROM pg_attribute WHERE attrelid = 'clients_clients'::regclass AND attname = 'name')] 
  AND contype = 'u';

如果查询返回空结果，说明数据库中确实没有该唯一约束，需要修复。

2. 通过Django迁移修复约束 #

方法一：自动生成迁移

运行以下命令，让Django检测模型与数据库的差异并生成修复迁移：

python manage.py makemigrations

如果Django能识别到name字段缺少唯一约束，会生成对应的迁移文件，接着执行：

python manage.py migrate

方法二：手动创建迁移

如果自动生成迁移未生效，手动创建一个空迁移并添加约束：

1. 生成空迁移文件：

python manage.py makemigrations clients --empty

2. 打开生成的迁移文件，修改operations部分为：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('clients', '替换为你的上一个迁移文件名'),  # 比如0002_auto_XXXX_XX_XX
    ]

    operations = [
        migrations.AlterField(
            model_name='clients',
            name='name',
            field=models.CharField(max_length=60, unique=True),
        ),
    ]

3. 执行迁移：

python manage.py migrate

3. 直接在数据库中添加约束（应急方案） #

如果迁移方式无法解决，可直接通过SQL命令在数据库中添加唯一约束：

ALTER TABLE clients_clients ADD CONSTRAINT clients_clients_name_key UNIQUE (name);

执行完成后，再重新运行python manage.py migrate即可完成外键的创建。

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