Django后台创建Appointment时触发IntegrityError外键约束失败

问题背景 #

自定义了继承AbstractUser的User模型，Doctor与User为一对一关联，Appointment模型通过外键关联User、Doctor、Symptom、Diagnosis。在Django Admin创建Appointment时持续抛出IntegrityError: FOREIGN KEY constraint failed，删除重建数据库后问题仍存在。

排查步骤 #

1. 验证AUTH_USER_MODEL配置 #

自定义User模型后，必须在settings.py中指定Django使用该模型作为认证用户模型：

# settings.py
AUTH_USER_MODEL = 'your_app_name.User'  # 替换为你的实际app名称

若未设置，Django会默认使用内置auth.User，导致Doctor、Appointment关联的User表与认证系统使用的表不一致，触发外键约束错误。

2. 手动在Shell中创建实例验证 #

通过Django Shell直接创建Appointment，排除Admin表单的影响：

# 进入Django Shell
python manage.py shell

# 导入依赖模块与模型
from django.utils import timezone
from your_app_name.models import User, Doctor, Symptom, Appointment

# 获取已存在的关联实例，替换为你的实际数据ID
user = User.objects.get(id=1)
doctor = Doctor.objects.get(id=1)
symptom = Symptom.objects.get(id=1)

# 尝试创建Appointment
try:
    appointment = Appointment.objects.create(
        user=user,
        doctor=doctor,
        symptoms=symptom,
        date=timezone.now()
    )
    print("创建成功")
except Exception as e:
    print(f"错误详情: {e}")

如果此步骤成功，说明问题出在Admin配置；若失败，错误信息会给出更具体的约束失败原因。

3. 检查数据库外键关联 #

查看数据库中Appointment表的外键约束，确认各外键字段指向的表正确：

• user_id应关联你的app下的user表（如core_user）
• doctor_id关联doctor表（如core_doctor）
• symptoms_id关联symptom表（如core_symptom）
  若外键指向错误的表（如默认的auth_user），说明AUTH_USER_MODEL未正确配置。

4. 确认关联对象的有效性 #

确保选择的User、Doctor、Symptom实例在数据库中真实存在，且未被删除：

• 检查Doctor实例对应的User是否存在：doctor.user（若使用软删除插件，需额外验证对象未被标记为删除）
• 确认Symptom实例未被误删除

5. 检查Admin配置 #

若使用自定义AppointmentAdmin，确保表单字段正确包含所有必填外键，且未在save_model方法中错误修改外键值：

# admin.py
from django.contrib import admin
from .models import Appointment

class AppointmentAdmin(admin.ModelAdmin):
    list_display = ('user', 'doctor', 'symptoms', 'date')
    fields = ('user', 'doctor', 'symptoms', 'diagnosis', 'date')  # 确保包含所有必填字段

admin.site.register(Appointment, AppointmentAdmin)

常见解决方法 #

1. 修复AUTH_USER_MODEL配置：添加配置后删除数据库、删除migrations文件夹下除__init__.py外的所有文件，重新执行python manage.py makemigrations和python manage.py migrate，再创建测试数据。
2. 重新生成迁移文件：若旧迁移文件存在冲突，清空migrations（保留__init__.py）后重新生成迁移。
3. 排查软删除插件影响：若使用了如django-soft-delete的插件，确保关联对象未被软删除（软删除对象仍会触发外键约束失败）。

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