HTML中添加购物车链接点击后跳转空白页问题排查与解决

问题描述 #

点击页面“加入购物车”按钮后，未跳转至购物车详情页，而是显示空白页面。相关代码如下：

product.html 代码 #

<a class="btn btn-secondary" href="{% url 'cart:add_cart' product.id %}">Add to Cart</a>

cart/views.py 代码 #

def add_cart(request, product_id):
    product = Product.objects.get(id=product_id)
    try:
        cart = Cart.objects.get(cart_id=_cart_id(request))
    except Cart.DoesNotExist:
        cart = Cart.objects.create(cart_id=_cart_id(request))
        cart.save()
    try:
        cart_item = CartItem.objects.get(product=product, cart=cart)
        if cart_item.quantity < cart_item.product.stock:
            cart_item.quantity += 1

        cart_item.save()
    except CartItem.DoesNotExist:
        cart_item = CartItem.objects.create(
            product=product,
            quantity=1,
            cart=cart
        )
        cart_item.save()
    return redirect('cart:cart_detail')

可能的原因及解决步骤 #

1. 未捕获商品不存在的异常 #

当传入的product_id无效（对应商品不存在）时，Product.objects.get(id=product_id)会抛出Product.DoesNotExist异常，代码未处理该异常会导致服务器内部错误，在DEBUG=False时呈现空白页。

修复代码：

def add_cart(request, product_id):
    try:
        product = Product.objects.get(id=product_id)
    except Product.DoesNotExist:
        # 重定向到商品列表页或自定义错误页
        return redirect('product_list')  # 替换为你的商品列表URL名称
    
    # 剩余原有代码保持不变
    try:
        cart = Cart.objects.get(cart_id=_cart_id(request))
    except Cart.DoesNotExist:
        cart = Cart.objects.create(cart_id=_cart_id(request))
        cart.save()
    try:
        cart_item = CartItem.objects.get(product=product, cart=cart)
        if cart_item.quantity < cart_item.product.stock:
            cart_item.quantity += 1

        cart_item.save()
    except CartItem.DoesNotExist:
        cart_item = CartItem.objects.create(
            product=product,
            quantity=1,
            cart=cart
        )
        cart_item.save()
    return redirect('cart:cart_detail')

2. _cart_id(request)函数实现异常 #

如果_cart_id函数未正确生成/获取购物车ID（比如未处理session），会导致创建或获取Cart对象失败，抛出未捕获的异常。

标准实现参考：

import uuid
from django.conf import settings

def _cart_id(request):
    # 从session读取cart_id，不存在则生成新UUID
    cart_id = request.session.get('cart_id')
    if not cart_id:
        cart_id = uuid.uuid4().hex
        request.session['cart_id'] = cart_id
        request.session.set_expiry(settings.SESSION_COOKIE_AGE)
    return cart_id

3. cart:cart_detail URL配置错误 #

若cart:cart_detail命名URL未在cart/urls.py中正确定义，或主路由未包含cart应用的URL，会导致重定向失败，返回404空白页。

检查cart/urls.py：

from django.urls import path
from . import views

app_name = 'cart'  # 必须设置命名空间

urlpatterns = [
    path('detail/', views.cart_detail, name='cart_detail'),
    path('add/<int:product_id>/', views.add_cart, name='add_cart'),  # 确认add_cart路由也正确
]

检查主urls.py：

from django.urls import path, include

urlpatterns = [
    # 其他路由...
    path('cart/', include('cart.urls')),
]

4. cart_detail视图自身异常 #

如果cart_detail视图存在错误（比如未正确渲染模板、抛出未捕获异常），即使重定向成功也会显示空白页。

检查cart_detail视图示例：

def cart_detail(request):
    try:
        cart = Cart.objects.get(cart_id=_cart_id(request))
        cart_items = CartItem.objects.filter(cart=cart)
    except Cart.DoesNotExist:
        cart_items = []
    return render(request, 'cart/cart_detail.html', {'cart_items': cart_items})

同时确认对应的模板cart/cart_detail.html存在且内容正常。

5. 开启DEBUG模式定位错误 #

在settings.py中设置DEBUG = True，空白页会显示详细错误堆栈，直接定位具体问题点。

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