Django中CBV ListView跨页面保留GET筛选条件的问题

问题根源 #

1. 查询参数丢失：列表页的分类筛选表单提交时，未携带之前的q_zip_code参数，导致新请求中无法获取已选邮编条件，query_zip变为None。
2. 筛选逻辑漏洞：原代码中若query_zip为空，会执行Q(zip_code__icontains=None)，这会筛选出邮政编码为None的记录，而非跳过邮编筛选。

解决方案 #

1. 修改视图逻辑（views.py）

动态构建筛选条件，同时将当前查询参数传递到模板以保留历史条件：

class ListingsView(ListView):
    model = Listing
    template_name = 'listings/list.html'
    context_object_name = 'listing_list'

    def get_queryset(self):
        # 获取基础查询集
        queryset = super().get_queryset()
        # 提取参数并去除首尾空格
        query_zip = self.request.GET.get('q_zip_code', '').strip()
        query_category = self.request.GET.get('q_category', '').strip()

        # 动态拼接筛选条件
        filters = Q()
        if query_zip:
            filters &= Q(zip_code__icontains=query_zip)
        if query_category:
            filters &= Q(category__icontains=query_category)
        
        # 有筛选条件时才执行过滤
        if filters:
            queryset = queryset.filter(filters)
        return queryset
    
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 复制当前GET参数，传递给模板用于表单隐藏字段
        context['current_query'] = self.request.GET.copy()
        return context

2. 修改列表页表单（list.html）

添加隐藏字段保留已选邮编参数，同时回显当前分类筛选值：

<form class="form-listing-search" action="{% url 'rental_listings_list' %}" method="get">
    <!-- 隐藏字段：保留已选的邮编参数 -->
    {% if current_query.q_zip_code %}
    <input type="hidden" name="q_zip_code" value="{{ current_query.q_zip_code }}">
    {% endif %}
    <!-- 回显当前分类筛选值 -->
    <input name="q_category" class="form-category" type="text" placeholder="Category" aria-label="Category" 
           value="{{ current_query.q_category|default:'' }}">
    <button class="button" type="submit">UPDATE</button>
</form>

效果说明 #

• 从首页提交邮编筛选后，列表页的分类表单会自动携带当前邮编参数，提交时不会丢失原有筛选条件。
• 支持单独筛选邮编、单独筛选分类，或同时筛选两个条件。
• 空参数时不会产生无效筛选，初始访问列表页时正常显示全部数据。

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