Django自定义User模型引发外键约束及注册异常问题求助

一、管理后台外键约束失败（IntegrityError）修复 #

可能原因 #

1. Profile模型外键配置错误：Profile模型的外键未正确关联自定义User，或缺少on_delete=models.CASCADE参数
2. 数据库迁移残留：项目初期使用默认User模型，切换自定义User后，旧迁移记录或数据表关联未清理干净
3. 关联模型外键指向错误：比如Destination的author字段未正确指向Account.User

修复步骤 #

• 检查Profile模型：确保外键正确关联自定义User并设置删除级联

  # Account/models.py 中的Profile模型
  class Profile(models.Model):
      user = models.OneToOneField(
          'Account.User',
          on_delete=models.CASCADE,  # 必须设置
          related_name='profile'
      )
      # 其他字段...
  

• 清理并重建迁移：
  1. 先备份数据库，避免数据丢失
  2. 删除Account、Destination等关联应用下migrations文件夹中除__init__.py外的所有文件
  3. 登录数据库，删除django_migrations表中对应应用的迁移记录
  4. 重新执行迁移命令：

     python manage.py makemigrations
     python manage.py migrate
     

• 确认其他模型外键：比如Destination的author字段必须指向自定义User：

  # Destination/models.py
  class Destination(models.Model):
      author = models.ForeignKey(
          'Account.User',
          on_delete=models.CASCADE,
          related_name='destinations'
      )
      # 其他字段...
  

二、注册视图邮箱校验失效修复 #

可能原因 #

1. 请求参数字段不匹配：前端传入的邮箱字段名与后端接收的不一致（比如前端传Email而非email）
2. 邮箱大小写敏感：数据库中存在小写邮箱，但用户传入大写时未被检测到
3. 变量赋值错误：后端代码中email变量实际接收的是用户名参数

修复步骤 #

• 确保正确获取请求参数：先标准化参数格式，统一转为小写并去除空格

  # 注册视图中获取参数的代码
  email = request.data.get('email', '').strip().lower()
  username = request.data.get('username', '').strip()
  

• 改为大小写不敏感的邮箱查询：

  from django.db.models import Q
  
  # 替换原邮箱校验逻辑
  if User.objects.filter(email__iexact=email).exists():
      return Response(
          data={"error": "Email has been already used."},
          status=status.HTTP_400_BAD_REQUEST
      )
  

• 调试参数值：在校验逻辑前打印参数，确认是否正确接收：

  print(f"Received email: {email}, username: {username}")
  

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