如何用django-filter实现布尔/空值的IN查询过滤？

你的代码核心问题有两个：

1. BoolInFilter继承后没有正确复用BooleanFilter的NullBooleanField字段解析逻辑，导致无法将true/false转为Python布尔值；
2. 原生的in查询无法直接匹配数据库中的NULL值（对应模型的None），需要手动处理空值条件。

修复方案一：自定义支持空布尔值的InFilter #

修改BoolInFilter，明确指定字段类并重写过滤逻辑，兼容布尔值和空值查询：

from django_filters import BaseInFilter, BooleanFilter
from django.forms import NullBooleanField
from django.db.models import Q

class BoolInFilter(BaseInFilter, BooleanFilter):
    # 指定使用NullBooleanField解析参数，支持true/false/null的转换
    field_class = NullBooleanField

    def filter(self, qs, value):
        if not value:
            return qs
        
        query = Q()
        for val in value:
            if val is None:
                # 匹配数据库中NULL值
                query |= Q(**{f"{self.field_name}__isnull": True})
            else:
                # 匹配布尔值
                query |= Q(**{self.field_name: val})
        return qs.filter(query)

class DefectFilter(django_filters.FilterSet):
    is_claim_submitted__in = BoolInFilter(field_name="is_claim_submitted")

    class Meta:
        model = Defect
        fields = ["id", "is_claim_submitted"]

修复方案二：使用MultipleChoiceFilter实现 #

这种方式更直观，通过自定义选项和过滤方法实现需求：

from django_filters import FilterSet, MultipleChoiceFilter
from django.db.models import Q
from .models import Defect

class DefectFilter(FilterSet):
    is_claim_submitted__in = MultipleChoiceFilter(
        choices=(
            ('true', True),
            ('false', False),
            ('null', None),
        ),
        method='filter_claim_submitted_in'
    )

    def filter_claim_submitted_in(self, qs, name, value):
        query = Q()
        for val in value:
            if val is None:
                query |= Q(is_claim_submitted__isnull=True)
            else:
                query |= Q(is_claim_submitted=val)
        return qs.filter(query)

    class Meta:
        model = Defect
        fields = ["id", "is_claim_submitted"]

使用说明 #

请求时需将参数放在查询字符串中，支持两种格式：

• 多参数形式：http://localhost:8000/api/v1/defects/?is_claim_submitted__in=true&is_claim_submitted__in=false&is_claim_submitted__in=null
• 逗号分隔形式：http://localhost:8000/api/v1/defects/?is_claim_submitted__in=true,false,null

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