如何根据传入参数动态过滤Django QuerySet？

问题场景 #

通过GET请求获取过滤参数，参数类型定义如下：

class FilterData(TypedDict):
    title: str
    min_price: int
    max_price: int
    freeDelivery: bool
    available: bool
    tags: list[int | None]

其中tags列表可能为空，此时该字段不应加入过滤查询。当前用if-else分支实现，但存在大量重复代码，希望找到更优的实现方式。

当前尝试的代码 #

if not tags:
    result = Product.objects.filter(
        Q(
            price__gte=filter_data["min_price"],
            price__lte=filter_data["max_price"],
        )
        & Q(freeDelivery=filter_data["freeDelivery"])
        & Q(available=filter_data["available"])
        & Q(title__icontains=filter_data["title"])
    ).order_by(order_field)
else:
    result = Product.objects.filter(
        Q(
            price__gte=filter_data["min_price"],
            price__lte=filter_data["max_price"],
        )
        & Q(freeDelivery=filter_data["freeDelivery"])
        & Q(available=filter_data["available"])
        & Q(title__icontains=filter_data["title"])
        & Q(tags__contains=[1, 2, 3])
    ).order_by(order_field)

最优实现方式 #

核心思路是逐步构建QuerySet对象，利用Django QuerySet的链式调用特性，先定义基础过滤条件，再动态添加可选条件，避免代码冗余。

优化后的代码

# 1. 初始化基础查询，包含所有必选过滤条件
base_query = Product.objects.filter(
    price__gte=filter_data["min_price"],
    price__lte=filter_data["max_price"],
    freeDelivery=filter_data["freeDelivery"],
    available=filter_data["available"],
    title__icontains=filter_data["title"]
)

# 2. 处理可选的tags过滤：仅当tags非空时追加条件
tags = filter_data["tags"]
# 先过滤掉列表中的None值（如果业务需要）
valid_tags = [tag for tag in tags if tag is not None]
if valid_tags:
    # 根据字段类型选择合适的查询方式：
    # - 若tags是多对多关联字段，用tags__in匹配关联任意传入标签的产品
    base_query = base_query.filter(tags__in=valid_tags)
    # - 若tags是JSONField存储的列表，用tags__contains匹配包含所有传入标签的产品
    # base_query = base_query.filter(tags__contains=valid_tags)

# 3. 最后添加排序
result = base_query.order_by(order_field)

方案优势 #

• 代码复用：避免重复编写大量相同的过滤条件，减少冗余代码
• 可读性强：逻辑分层清晰，基础条件与动态可选条件分开处理
• 扩展性高：后续新增可选过滤参数时，只需添加新的判断分支，无需修改基础查询代码

内容的提问来源于stack exchange，提问作者Андрей