Django新增外键后migrate报错：NOT NULL约束失败

核心问题 #

你的外键字段设置存在两处冲突/错误：

• 无效的默认值：外键存储的是AccountingClass模型的整数ID，但你设置了default=""（空字符串），空字符串无法转换为合法的整数ID，执行migrate时Django会尝试给现有数据的该字段填充这个无效值，触发数据库的完整性约束报错。
• 字段约束的矛盾：你同时设置了blank=False和null=True，blank=False要求表单提交时该字段不能为空，但null=True允许数据库存储NULL值。在migrate阶段，现有数据没有合法的外键值，而无效的默认值又无法满足约束，最终导致报错。

修复步骤 #

方案1：允许现有数据暂时为NULL（推荐） #

1. 修改外键字段定义，删除无效的default=""：

accounting_class = models.ForeignKey("AccountingClass", on_delete=models.SET_NULL, blank=False, null=True, help_text="The accounting class of the object")

2. 重新执行makemigrations my_app，此时Django会提示你如何处理现有记录的该字段，选择设置为NULL即可。
3. 再执行migrate就能成功。

方案2：给现有数据设置默认关联实例 #

如果你希望现有数据都关联到一个默认的AccountingClass对象：

1. 先在数据库中创建一个默认的AccountingClass实例（比如通过后台管理页面或Django Shell）。
2. 修改外键字段的default为该实例的ID（假设默认实例ID为1）：

accounting_class = models.ForeignKey("AccountingClass", on_delete=models.SET_NULL, default=1, blank=False, null=True, help_text="The accounting class of the object")

3. 重新执行makemigrations和migrate即可。

额外说明 #

如果你的业务逻辑允许用户在表单中不选择该字段（但数据库可以存NULL），建议把blank=False改为blank=True，这样表单验证规则和数据库约束会更匹配。

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