Django购物车应用持续触发FOREIGN KEY CONSTRAINT failed错误求助

问题场景 #

开发类图书馆Django Web应用时，购物车模块在管理后台添加商品到购物车并保存时，必然触发FOREIGN KEY CONSTRAINT failed错误。已将模型中用户关联从默认User修正为video_rental应用的CustomUser，但问题仍未解决。

相关代码 #

购物车模型（cart/models.py）

from django.db import models
from video_rental.models import Movie, CustomUser
from django.conf import settings

class CartItem(models.Model):
    movie = models.ForeignKey(Movie, on_delete=models.CASCADE)
    quantity = models.PositiveIntegerField(default=0)
    user = models.ForeignKey(CustomUser, on_delete=models.CASCADE)
    date_added = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return f'{self.quantity} x {self.movie.title}'

购物车视图（cart/views.py）

from django.shortcuts import render, redirect
from .models import CartItem
from video_rental.models import Movie
from django.http import HttpResponse

def movie_list(request):
    movies = Movie.objects.all()
    return render(request, 'myapp/index.html', {'products': movies})

def view_cart(request):
    cart_items = CartItem.objects.filter(user=request.user)
    return render(request, 'myapp/cart.html', {'cart_items': cart_items})

def add_to_cart(request, title):
    movie= Movie.objects.get(title=title)
    cart_item, created = CartItem.objects.get_or_create(movie=movie, user=request.user)
    cart_item.quantity += 1
    cart_item.save()
    return redirect('cart:view_cart')

def remove_from_cart(request, title):
    cart_item = CartItem.objects.get(title=title)
    cart_item.delete()
    return redirect('cart:view_cart')

def home(request):
    return HttpResponse('Hello, World!')

错误原因分析 #

1. 管理后台用户字段未正确赋值
   CartItem模型中user是必填外键，若在管理后台添加CartItem时未指定有效的CustomUser实例，或后台表单未自动关联当前登录用户，会导致外键引用无效，触发约束错误。

2. 数据库迁移不完整
   将用户关联从默认User改为CustomUser后，若未重新生成并执行正确的迁移，数据库中cart_cartitem表的user_id字段仍关联旧的用户表（如auth_user），而非video_rental_customuser，导致外键约束不匹配。

3. AUTH_USER_MODEL未正确配置
   若settings.py中未设置AUTH_USER_MODEL = 'video_rental.CustomUser'，Django仍会默认使用内置User模型，与CartItem中关联的CustomUser不兼容，引发外键冲突。

4. remove_from_cart视图逻辑错误
   CartItem模型本身无title字段，CartItem.objects.get(title=title)会抛出查询错误（虽非当前后台错误的直接原因，但需修复）。

解决办法 #

1. 修复管理后台用户关联逻辑 #

在cart/admin.py中注册CartItem时，添加自动赋值当前登录用户的逻辑，避免手动选择出错：

from django.contrib import admin
from .models import CartItem

class CartItemAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        # 若未指定用户，自动设置为当前后台登录用户
        if not obj.user_id:
            obj.user = request.user
        super().save_model(request, obj, form, change)

admin.site.register(CartItem, CartItemAdmin)

2. 重新执行数据库迁移 #

• 先备份数据库（避免数据丢失）
• 删除cart应用下migrations文件夹中除__init__.py外的所有迁移文件
• 重新生成迁移：

  python manage.py makemigrations cart
  

• 执行迁移：

  python manage.py migrate cart
  

3. 配置AUTH_USER_MODEL #

确保settings.py中指定自定义用户模型：

AUTH_USER_MODEL = 'video_rental.CustomUser'

4. 修复remove_from_cart视图 #

通过关联的Movie的title字段查询CartItem：

def remove_from_cart(request, title):
    cart_item = CartItem.objects.get(movie__title=title, user=request.user)
    cart_item.delete()
    return redirect('cart:view_cart')

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