如何在Django中动态构建带OR条件的查询过滤逻辑

需求 #

• 勾选Individual时，仅显示partner字段为individual的记录
• 勾选多个选项（如Individual和Couple）时，展示所有符合任一选中条件的记录

当前冗余实现 #

使用大量分支判断拼接Q对象，代码繁琐且不易维护：

if individual and not couple and family:
    query = query.filter(Q(partner="individual") | Q(partner="family"))

if individual and couple and not family:
    query = query.filter(Q(partner="individual") | Q(partner="couple"))

if not individual and couple and family:
    query = query.filter(Q(partner="family") | Q(partner="couple"))

if individual and not couple and not family:
    query = query.filter(partner="individual")

if not individual and couple and not family:
    query = query.filter(partner="couple")

if not individual and not couple and family:
    query = query.filter(partner="family")

期望逻辑参考（PHP思路） #

希望实现类似动态拼接OR条件的简洁写法：

$sql = "SELECT * FROM abc WHERE";
if($individual){
   $sql .= " partner=individual"; 
}
if($couple){
   $sql .= " OR partner=couple"; 
}
if($family){
   $sql .= " OR partner=family"; 
}
$sql .= " order by id desc";

简洁实现方案 #

方案1：动态构建Q对象 #

直接模拟PHP的拼接逻辑，用|=操作符逐个添加OR条件：

from django.db.models import Q

# 初始化空Q对象作为条件容器
filter_conditions = Q()

# 根据勾选状态添加对应OR条件
if individual:
    filter_conditions |= Q(partner="individual")
if couple:
    filter_conditions |= Q(partner="couple")
if family:
    filter_conditions |= Q(partner="family")

# 仅当有选中条件时应用过滤
if filter_conditions:
    query = query.filter(filter_conditions)

这个写法和你参考的PHP逻辑完全对应，新增选项时只需加一行判断，代码清晰易维护。

方案2：列表推导式批量生成条件 #

如果选项较多，可先定义选项映射列表，再批量生成Q对象并合并：

from django.db.models import Q

# 定义选项勾选状态与对应partner值的映射
partner_mapping = [
    (individual, "individual"),
    (couple, "couple"),
    (family, "family"),
]

# 筛选出已勾选的选项，生成对应的Q对象列表
selected_conditions = [Q(partner=val) for checked, val in partner_mapping if checked]

# 合并所有Q对象为OR条件并应用过滤
if selected_conditions:
    query = query.filter(*selected_conditions)

这种方式扩展性更强，新增选项只需在partner_mapping中添加一行即可，无需修改过滤逻辑。

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