Django迁移遇IntegrityError：slug字段重复空值条目求助

1. 找到对应的迁移文件 #

• 打开出问题的app文件夹，找到migrations目录，里面是按编号排序的文件（比如0003_add_slug_unique.py），找最近生成的、和slug修改相关的那个。

2. 修改迁移文件内容 #

打开这个迁移文件，原来的核心代码大概是这样：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('你的app名', '上一个迁移文件的编号'),
    ]

    operations = [
        migrations.AlterField(
            model_name='你的模型名',
            name='slug',
            field=models.SlugField(unique=True),  # 加了unique=True导致报错
        ),
    ]

我们要把它改成三步操作，一步步来：

第一步：临时移除unique约束，允许slug为空 #

把原来的AlterField改成：

migrations.AlterField(
    model_name='你的模型名',
    name='slug',
    field=models.SlugField(blank=True, null=True),  # 去掉unique=True，允许空值
),

第二步：批量填充空slug为唯一值 #

在第一步的AlterField后面，添加自定义Python代码来生成唯一slug：

# 定义填充slug的函数
def populate_slugs(apps, schema_editor):
    # 获取你的模型
    Model = apps.get_model('你的app名', '你的模型名')
    # 筛选所有slug为空或空字符串的对象
    for obj in Model.objects.filter(slug__isnull=True) | Model.objects.filter(slug=''):
        # 用模型的title字段生成基础slug（没有title就换其他字段）
        from django.utils.text import slugify
        base_slug = slugify(obj.title)
        current_slug = base_slug
        counter = 1
        # 避免slug重复，重复就加数字后缀
        while Model.objects.filter(slug=current_slug).exists():
            current_slug = f"{base_slug}-{counter}"
            counter += 1
        obj.slug = current_slug
        obj.save()

# 添加执行这个函数的迁移操作
migrations.RunPython(populate_slugs),

第三步：恢复slug的unique约束 #

在RunPython后面，再加一个AlterField把唯一约束加回来：

migrations.AlterField(
    model_name='你的模型名',
    name='slug',
    field=models.SlugField(unique=True, blank=True),  # 恢复unique=True，保留blank方便后台输入
),

修改后的完整迁移文件示例：

from django.db import migrations, models
from django.utils.text import slugify

def populate_slugs(apps, schema_editor):
    Model = apps.get_model('你的app名', '你的模型名')
    for obj in Model.objects.filter(slug__isnull=True) | Model.objects.filter(slug=''):
        base_slug = slugify(obj.title)
        current_slug = base_slug
        counter = 1
        while Model.objects.filter(slug=current_slug).exists():
            current_slug = f"{base_slug}-{counter}"
            counter += 1
        obj.slug = current_slug
        obj.save()

class Migration(migrations.Migration):
    dependencies = [
        ('你的app名', '0002_xxx'),  # 替换成你之前的迁移文件编号
    ]

    operations = [
        migrations.AlterField(
            model_name='你的模型名',
            name='slug',
            field=models.SlugField(blank=True, null=True),
        ),
        migrations.RunPython(populate_slugs),
        migrations.AlterField(
            model_name='你的模型名',
            name='slug',
            field=models.SlugField(unique=True, blank=True),
        ),
    ]

3. 执行迁移 #

保存修改后的文件，在终端运行：

python manage.py migrate

关键概念说明 #

• 迁移文件：Django用来记录数据库结构变化的文件，每次makemigrations都会生成一个，存在app的migrations目录下。
• AlterField操作：用来修改数据库中已有字段的属性，比如是否唯一、是否允许空、字段类型等。
• RunPython操作：允许在迁移过程中执行自定义Python代码，这里用来批量生成唯一slug，避免空字符串重复触发唯一键错误。

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