Django笔记应用添加Foreign Key执行migrate时触发NOT NULL constraint failed错误求助

这个错误其实很常见——你给Note模型新增了author外键字段（默认要求非空），但数据库里已经存在一些没有关联作者的旧笔记记录。迁移时Django没法自动给这些旧笔记填充author_id值，所以触发了NOT NULL constraint failed约束错误。

下面给你几个适合初学者的解决方案，按需选择：

方案一：清空现有笔记数据（最简单，适合开发测试阶段） #

如果你的笔记数据不重要，直接清空Note表后再迁移就行：

1. 打开Django shell执行删除操作：

python manage.py shell

>>> from new__api.models import Note
>>> Note.objects.all().delete()
>>> exit()

2. 重新运行迁移命令：

python manage.py migrate

方案二：允许author字段临时为空 #

先让author字段允许为空，完成迁移后再补填数据（或后续调整为非空）：

1. 修改Note模型的author字段，添加null=True和blank=True：

author = models.ForeignKey(User, on_delete=models.CASCADE, null=True, blank=True)

2. 生成新的迁移文件并执行迁移：

python manage.py makemigrations
python manage.py migrate

3. 之后你可以通过Django Admin或shell给旧笔记手动关联作者，确认所有笔记都有作者后，再把null=True, blank=True去掉，重新迁移即可。

方案三：给旧笔记设置默认作者（适合需要保留数据的场景） #

如果要保留现有笔记，且有明确的默认作者，可以这么做：

1. 先确保数据库里已经创建了一个可用的用户（比如通过Admin后台创建一个测试用户）。
2. 运行makemigrations生成迁移文件，此时Django会提示你是否要给现有记录设置默认值，直接输入该用户的ID即可；或者你可以手动修改生成的迁移文件，添加自动填充逻辑：

from django.db import migrations, models

def set_default_author(apps, schema_editor):
    User = apps.get_model('new__api', 'User')
    Note = apps.get_model('new__api', 'Note')
    # 替换成你实际的默认用户查询条件
    default_user = User.objects.get(username="test_admin")
    Note.objects.filter(author__isnull=True).update(author=default_user)

class Migration(migrations.Migration):
    dependencies = [
        ('new__api', '000X_previous_migration_name'), # 替换成你之前的迁移文件名
    ]

    operations = [
        migrations.AddField(
            model_name='note',
            name='author',
            field=models.ForeignKey(on_delete=models.CASCADE, to='new__api.User'),
        ),
        migrations.RunPython(set_default_author),
    ]

3. 最后执行迁移命令：

python manage.py migrate

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