Django 1.7.11外键关联报错：引用表无匹配唯一约束

我之前在维护老版本Django项目时遇到过完全一致的问题——多层抽象继承的模型，默认主键明明在数据库里是唯一的，但新增外键关联时迁移系统就是识别不到对应的约束。下面是几个经过验证的可行方案：

方案一：显式声明Photo模型主键并Fake迁移 #

因为多层抽象继承可能导致Django元数据没正确标记默认id为主键（虽然数据库里它确实是主键），显式声明可以让迁移系统正确识别：

1. 在你的Photo模型里添加显式主键定义：

from django.db import models

class Photo(YourAbstractBaseClass1, YourAbstractBaseClass2):
    id = models.AutoField(primary_key=True)
    # 其他原有字段保持不变

2. 生成Photo模型的迁移文件：

python manage.py makemigrations photos

3. 由于id字段已经在数据库中存在，用--fake让Django只更新迁移状态，不修改数据库：

python manage.py migrate photos --fake

4. 重新生成Material模型的迁移（如果之前的迁移文件有问题可以先删除），再执行迁移：

python manage.py makemigrations points
python manage.py migrate points

方案二：手动修改迁移文件，用RunSQL添加外键 #

如果方案一不生效，可以绕过Django自动生成的外键SQL，直接写数据库原生语句：

1. 先执行makemigrations生成Material模型的迁移文件（比如你提到的0014_auto_20180124_0528.py）。

2. 打开这个迁移文件，替换原有外键添加逻辑为RunSQL操作：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('points', '0013_your_previous_migration'),
        ('photos', '00xx_photo_latest_migration'),
    ]

    operations = [
        # 先添加外键字段（无约束）
        migrations.AddField(
            model_name='material',
            name='photo_id',
            field=models.IntegerField(null=True),
        ),
        # 手动添加外键约束
        migrations.RunSQL(
            "ALTER TABLE points_material ADD CONSTRAINT points_material_photo_id_fkey FOREIGN KEY (photo_id) REFERENCES photos_photo(id);",
            # 可选：回滚时的SQL
            "ALTER TABLE points_material DROP CONSTRAINT points_material_photo_id_fkey;"
        ),
        # 可选：如果需要非空约束，再修改字段
        migrations.AlterField(
            model_name='material',
            name='photo_id',
            field=models.IntegerField(null=False),
        ),
    ]

3. 执行迁移：

python manage.py migrate points

方案三：Fake迁移后手动在数据库添加约束 #

如果不想修改代码和迁移文件，也可以先同步模型状态，再手动操作数据库：

1. 执行fake迁移，让Django认为Material模型已创建：

python manage.py migrate points --fake

2. 登录你的数据库，执行添加外键的SQL语句：

ALTER TABLE points_material ADD CONSTRAINT points_material_photo_id_fkey FOREIGN KEY (photo_id) REFERENCES photos_photo(id);

3. 确保Material模型的外键定义正确，后续操作就不会再出现问题了。

问题根源 #

Django 1.7的迁移系统在处理多层抽象继承模型时存在bug，虽然数据库中photos_photo的id是主键（自带唯一约束），但迁移生成的SQL无法正确匹配到对应的约束名称，从而抛出ProgrammingError。上面的方案都是通过显式声明主键、手动干预迁移过程来绕过这个老版本的缺陷。

内容的提问来源于stack exchange，提问作者Mitchell van Zuylen