Django电商购物车：同ProductId异OptionId时增减数量报错

问题核心 #

你用get()查询购物车条目时只匹配了ProductId，但带选项的商品需要**同时匹配ProductId和OptionId**才能唯一标识一个CartItem实例。忽略OptionId的查询会导致同商品不同选项的条目被同时命中，触发MultipleObjectsReturned错误。

具体解决方案 #

1. 修正查询逻辑，同时匹配商品和选项 #

在处理商品添加、数量增减时，必须将cart、product、option三个字段作为查询条件（option可为None，对应无选项商品），确保唯一命中一个条目。

示例：添加/递增商品数量

from django.shortcuts import get_object_or_404
from .models import Cart, CartItem, Product, ProductOption

def add_to_cart(request):
    current_cart = get_object_or_404(Cart, user=request.user)
    product_id = request.POST.get('product_id')
    option_id = request.POST.get('option_id')  # 前端传递选项ID，无则为None

    product = get_object_or_404(Product, id=product_id)
    option = get_object_or_404(ProductOption, id=option_id) if option_id else None

    try:
        # 同时匹配购物车、商品、选项
        cart_item = CartItem.objects.get(
            cart=current_cart,
            product=product,
            option=option
        )
        # 存在则递增数量
        cart_item.quantity += 1
        cart_item.save()
    except CartItem.DoesNotExist:
        # 不存在则创建新条目
        CartItem.objects.create(
            cart=current_cart,
            product=product,
            option=option,
            quantity=1
        )
    except CartItem.MultipleObjectsReturned:
        # 兜底处理历史脏数据：合并数量并删除重复条目
        cart_items = CartItem.objects.filter(
            cart=current_cart,
            product=product,
            option=option
        )
        main_item = cart_items.first()
        main_item.quantity += sum(item.quantity for item in cart_items[1:])
        main_item.save()
        cart_items.exclude(id=main_item.id).delete()

示例：递减商品数量（为0时删除）

如果前端能传递cart_item_id，直接通过ID查询最稳妥（避免重复匹配）：

def decrease_cart_item(request):
    current_cart = get_object_or_404(Cart, user=request.user)
    cart_item_id = request.POST.get('cart_item_id')

    try:
        cart_item = CartItem.objects.get(id=cart_item_id, cart=current_cart)
        if cart_item.quantity > 1:
            cart_item.quantity -= 1
            cart_item.save()
        else:
            # 数量为0时删除条目
            cart_item.delete()
    except CartItem.DoesNotExist:
        # 处理条目已被删除的情况
        pass

如果前端只能传递商品和选项信息，继续用组合条件查询：

def decrease_cart_item(request):
    current_cart = get_object_or_404(Cart, user=request.user)
    product_id = request.POST.get('product_id')
    option_id = request.POST.get('option_id')

    product = get_object_or_404(Product, id=product_id)
    option = get_object_or_404(ProductOption, id=option_id) if option_id else None

    try:
        cart_item = CartItem.objects.get(cart=current_cart, product=product, option=option)
        if cart_item.quantity > 1:
            cart_item.quantity -= 1
            cart_item.save()
        else:
            cart_item.delete()
    except CartItem.DoesNotExist:
        pass
    except CartItem.MultipleObjectsReturned:
        # 合并重复条目后再处理递减
        cart_items = CartItem.objects.filter(cart=current_cart, product=product, option=option)
        total_quantity = sum(item.quantity for item in cart_items)
        main_item = cart_items.first()
        if total_quantity > 1:
            main_item.quantity = total_quantity - 1
            main_item.save()
            cart_items.exclude(id=main_item.id).delete()
        else:
            cart_items.delete()

2. 模型层添加联合唯一约束 #

从根源避免重复条目，在CartItem模型中添加联合唯一约束，确保同一个购物车里，同商品同选项的条目只能存在一个：

class CartItem(models.Model):
    cart = models.ForeignKey(Cart, on_delete=models.CASCADE)
    product = models.ForeignKey(Product, on_delete=models.CASCADE)
    option = models.ForeignKey(ProductOption, on_delete=models.SET_NULL, null=True, blank=True)
    quantity = models.PositiveIntegerField(default=1)

    class Meta:
        # Django 2.2+ 推荐使用 constraints
        constraints = [
            models.UniqueConstraint(
                fields=['cart', 'product', 'option'],
                name='unique_cart_product_option'
            )
        ]
        # Django < 2.2 可使用以下代码替代
        # unique_together = ('cart', 'product', 'option')

添加约束后，数据库会阻止重复条目被创建，彻底避免MultipleObjectsReturned错误。

3. 前端传递必要参数 #

确保前端在发起请求时，对于带选项的商品，必须传递option_id；无选项商品则传递null或不传递。如果能直接传递cart_item_id，可以进一步简化后端逻辑并提升准确性。

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