Django添加外键字段迁移报错：psycopg2.IntegrityError（非空约束）

我之前也碰到过一模一样的问题，你遇到的这个错误核心有两个原因：一是外键字段的默认值设置错误，二是现有数据没有对应关联值时，新增非空外键会触发数据库完整性校验失败。

问题根源拆解 #

• 外键的default=''无效且错误：外键字段在数据库中存储的是关联模型（这里是TrainingSubject）的主键值（通常是整数类型），你设置default=''相当于试图给整数类型的email_to_id字段插入空字符串，这本身就不符合数据类型要求，数据库肯定会报错。
• 未允许字段为NULL：你虽然加了blank=True，但这个参数只是控制表单提交时允许空值，数据库层面默认还是要求字段非空。而你的Training表已经有现有记录，新增这个外键字段时，Django需要给所有旧记录填充默认值，但你设置的默认值无效，且没允许字段为NULL，自然触发IntegrityError。

正确的解决步骤 #

1. 修改Training模型的外键字段

更新email_to字段，添加null=True允许数据库存储NULL值，同时指定on_delete（Django 3.2+版本要求外键必须设置该参数），暂时去掉错误的default=''：

class Training(models.Model):
    """Training model for storing trainings."""
    subject = models.ForeignKey(TrainingSubject, verbose_name=_('subject'), related_name='trainings', on_delete=models.CASCADE)
    email_to = models.ForeignKey(TrainingSubject, related_name='manager_email', null=True, blank=True, on_delete=models.SET_NULL)
    date = models.DateTimeField(_('date'))
    # 其他字段...

说明：on_delete=models.SET_NULL表示当关联的TrainingSubject被删除时，该字段会被设为NULL，如果你需要其他行为可以替换为CASCADE/PROTECT等。

2. 生成并执行迁移

运行以下命令完成数据库迁移：

python manage.py makemigrations
python manage.py migrate

这时候因为字段允许NULL，Django会自动给现有Training记录的email_to_id填充NULL值，不会触发完整性错误。

3. （可选）后续将字段改为非空

如果之后你希望email_to字段必须有值，可以：

• 先通过后台管理或脚本给所有现有Training记录设置有效的email_to关联值；
• 再修改模型去掉null=True：

  email_to = models.ForeignKey(TrainingSubject, related_name='manager_email', blank=True, on_delete=models.SET_NULL)
  

• 重新生成迁移并执行即可。

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