Django迁移出现IntegrityError外键无效报错的修复方法

blank=True仅控制Django表单、Admin后台的输入校验规则，不生效于数据库层约束；on_delete=models.DO_NOTHING仅定义关联State数据被删除时的联动行为，两个参数都无法解决现有数据的外键匹配失败问题。
触发报错的直接原因：

• 外键字段未配置null=True，数据库层默认禁止该字段存储NULL值，历史业务数据才会用空字符串''作为无关联状态的占位值
• 现有list表中State字段存储的''值，在关联State表的state字段中无对应匹配记录，迁移时外键约束校验直接拦截

1. 调整List模型的State外键字段，补充null=True参数，开放数据库层的NULL存储权限：

class List(models.Model):
    Lid = models.AutoField(primary_key=True)
    Name = models.CharField(max_length=100)
    addr1 = models.CharField(max_length=100)
    addr2 = models.CharField(max_length=100) 
    City = models.CharField(max_length=40) 
    State = models.ForeignKey(
        State,
        blank=True,
        null=True,
        on_delete=models.DO_NOTHING,
        default=None,
        to_field="state",
        db_column="State"
    )

2. 执行python manage.py makemigrations生成迁移文件，不要直接执行migrate操作。
3. 打开对应app下migrations目录内新生成的迁移文件（文件名格式为00xx_alter_list_state.py），在字段修改操作前插入脏数据清理逻辑，把所有存空字符串的无效外键替换为合法的NULL值：

from django.db import migrations

def clean_invalid_state(apps, schema_editor):
    ListModel = apps.get_model('替换为你的app名称', 'List')
    ListModel.objects.filter(State='').update(State=None)

class Migration(migrations.Migration):
    # 原有dependencies内容保持不变
    dependencies = [
        ('替换为你的app名称', '00xx_前置迁移文件名'),
    ]

    operations = [
        # 先执行脏数据清理
        migrations.RunPython(clean_invalid_state),
        # 原有AlterField操作保持不变
        migrations.AlterField(
            model_name='list',
            name='State',
            field=models.ForeignKey(blank=True, null=True, default=None, on_delete=django.db.models.deletion.DO_NOTHING, to='替换为你的app名称.State', to_field='state', db_column='State'),
        ),
    ]

4. 执行python manage.py migrate即可完成迁移，不会再触发外键校验报错。

如果业务逻辑要求必须用空字符串''作为无关联标识、不能使用NULL，可以先在State表中插入一条state字段值为''的记录，让外键能找到匹配值再执行迁移，但该方案不符合数据库外键设计规范，不推荐使用。

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