Django模型新增字段触发IntegrityError问题求助

问题分析 #

给已有数据的UserSubs表新增plan_start_date字段时，即便添加了null=True仍报错，核心原因是：

• 首次生成迁移文件时，字段被设置为NOT NULL约束，且未指定默认值，数据库尝试给现有行填充NULL时违反约束
• 后续添加null=True后，若未生成正确的修改字段约束的迁移，数据库层面的NOT NULL限制仍未解除

解决步骤 #

1. 修正模型字段配置 #

确保字段同时设置null=True（允许数据库存储空值）和blank=True（允许表单提交空值，可选但推荐）：

class UserSubs(models.Model):
    subscription_start_date = models.DateTimeField(default=None)
    plan_start_date = models.DateTimeField(null=True, blank=True, default=None)  # 修正后的字段
    current_period_start = models.DateTimeField(default=None)
    current_period_end = models.DateTimeField(default=None)
    canceled_at = models.DateTimeField(default=now)

2. 重新生成并执行迁移 #

• 删除之前生成的关于plan_start_date的错误迁移文件（若已生成）
• 运行命令生成新迁移：

  python manage.py makemigrations
  

• 执行迁移：

  python manage.py migrate
  

3. 若仍报错，手动调整迁移文件 #

检查生成的迁移文件，确保它包含修改字段约束的操作：

# 迁移文件中的operations应类似如下
operations = [
    migrations.AlterField(
        model_name='usersubs',
        name='plan_start_date',
        field=models.DateTimeField(default=None, null=True, blank=True),
    ),
]

保存后再次执行migrate即可。

备选方案：给现有数据填充默认值 #

如果需要给现有行的plan_start_date设置具体值（而非允许空），可以在迁移中添加数据填充操作：

1. 生成空迁移：

   python manage.py makemigrations --empty subscription
   

2. 在迁移文件中添加RunPython操作：

   from django.db import migrations
   from django.utils import timezone
   
   def fill_plan_start_date(apps, schema_editor):
       UserSubs = apps.get_model('subscription', 'UserSubs')
       # 用subscription_start_date的值填充，或自定义逻辑
       UserSubs.objects.filter(plan_start_date__isnull=True).update(plan_start_date=timezone.now())
   
   class Migration(migrations.Migration):
       dependencies = [
           # 依赖之前的迁移版本号，比如('subscription', '0002_usersubs_plan_start_date')
       ]
   
       operations = [
           migrations.RunPython(fill_plan_start_date),
           migrations.AlterField(
               model_name='usersubs',
               name='plan_start_date',
               field=models.DateTimeField(default=None),
           ),
       ]
   

3. 执行迁移即可。

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