Django类视图返回多值问题：ListView无法传递额外变量到模板

你的问题出在get_queryset方法的职责边界上：这个方法只能返回单个QuerySet对象，用来提供页面展示的核心数据。你现在返回(products, total_stock)元组，ListView无法解析这种格式，直接导致模板接收不到任何有效数据。

正确实现方式：重写get_context_data添加额外上下文 #

ListView提供了get_context_data方法，专门用来添加需要传递给模板的额外变量，这才是处理这类需求的标准做法。修改后的视图代码如下：

from django.views.generic import ListView
from django.db.models import Sum
from .models import Product

class ShopListing(ListView):
    template_name = "webshop/shop_listing.html"
    context_object_name = 'shop_listing'

    def get_queryset(self):
        # get_queryset只负责返回产品查询集
        return Product.objects.all()

    def get_context_data(self, **kwargs):
        # 先获取父类生成的默认上下文
        context = super().get_context_data(**kwargs)
        # 从上下文里拿到产品列表，计算总库存（or 0处理库存为空的情况）
        products = context['shop_listing']
        total_stock = products.aggregate(sum=Sum('stock'))['sum'] or 0
        # 将总库存添加到上下文，模板即可直接调用
        context['total_stock'] = total_stock
        return context

模板代码无需修改 #

你原来的模板代码可以直接使用：

<p><strong>{{total_stock}}</strong> items are currently available</p>

另一种简化写法 #

如果不想分开写get_queryset，也可以直接在get_context_data里一次性处理所有数据：

def get_context_data(self, **kwargs):
    context = super().get_context_data(**kwargs)
    products = Product.objects.all()
    context['shop_listing'] = products
    context['total_stock'] = products.aggregate(sum=Sum('stock'))['sum'] or 0
    return context

核心逻辑记住：get_queryset只负责返回核心查询集，额外数据全部通过get_context_data注入上下文。

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