Django Admin新增/修改模型时触发IntegrityError（外键约束失败）

错误信息 #

IntegrityError at /admin/main/user/2/change/
FOREIGN KEY constraint failed

环境信息：

• Django Version: 4.2.4
• Exception Type: IntegrityError
• Exception Location: C:\Users\Administrator\Desktop\oracle\Site #041\site\env\Lib\site-packages\django\db\backends\base\base.py, line 313, in _commit
• Occurred during: django.contrib.admin.options.change_view
• Python Version: 3.12.0

自定义管理界面操作正常，但Django Admin增改模型时触发外键约束失败，可按以下步骤排查修复：

1. 定位涉及的外键字段 #

打开main/models.py中的User模型，找出所有ForeignKey/OneToOneField字段，确认：

• 是否设置了null=True（若未设置则为必填项）
• on_delete选项（如PROTECT/CASCADE）是否符合业务逻辑
• 字段是否关联了正确的模型

示例：

class User(models.Model):
    group = models.ForeignKey(Group, on_delete=models.PROTECT)  # 必填外键，关联Group模型
    profile = models.OneToOneField(UserProfile, on_delete=models.SET_NULL, null=True)

2. 检查Admin表单提交数据 #

通过浏览器开发者工具查看Admin表单提交的Form Data，确认外键字段的值是否为关联表中存在的有效ID：

• 若外键字段被排除在Admin表单之外（通过exclude或未加入fields），检查是否有默认值或自动赋值逻辑导致无效引用
• 若表单显示外键选择框，确认选中的对象未被删除

3. 排查ModelAdmin自定义逻辑 #

如果自定义了UserAdmin的save_model方法或其他钩子函数，检查是否存在修改外键的错误逻辑：

class UserAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        # 错误示例：手动赋值了不存在的外键ID
        # obj.group_id = 999
        obj.save()

移除或修正错误的手动赋值逻辑，确保外键指向有效对象。

4. 修复数据库数据一致性 #

若数据库中存在无效的外键引用（比如user表ID=2的记录关联了已删除的Group），通过Django Shell修复：

python manage.py shell

from main.models import User, Group
user = User.objects.get(id=2)
# 设置一个有效的关联对象
valid_group = Group.objects.first()
user.group = valid_group
user.save()

5. 检查信号（Signal）干扰 #

排查是否为User模型设置了pre_save/post_save信号，信号中的逻辑可能意外修改了外键字段，导致违反约束：

• 查看signals.py或模型文件中的信号注册代码
• 临时注释信号逻辑，验证Admin操作是否恢复正常

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