DjangoFilterBackend如何过滤null值字段？已配置__all__字段过滤

嘿，我来帮你搞定这个问题！你当前用filter_fields = '__all__'的配置确实只支持精确匹配，没法直接过滤NULL值，不过不用大改ViewSet，有几个简洁的解决方案：

方案一：自定义FilterSet（推荐） #

这是最规范的做法，只需要新增一个FilterSet类，替换掉原来的filter_fields配置即可：

首先导入必要的模块：

from django_filters import FilterSet
from .models import Entity

然后定义你的FilterSet，给所有字段自动添加精确匹配和NULL过滤的支持：

class EntityFilter(FilterSet):
    class Meta:
        model = Entity
        fields = {
            field.name: ['exact', 'isnull'] 
            for field in Entity._meta.fields
        }

最后修改你的ViewSet，把filter_fields = '__all__'替换成自定义FilterSet：

class EntitiesViewSet(viewsets.ModelViewSet):
    queryset = Entity.objects.all()
    serializer_class = EntitiesSerializer
    pagination_class = StandardResultsSetPagination
    filter_backends = (DjangoFilterBackend,)
    filter_class = EntityFilter  # 替换为自定义FilterSet

现在你就可以用以下方式过滤NULL值了：

• 查找parent为NULL的记录：/persons/?parent__isnull=True
• 查找parent不为NULL的记录：/persons/?parent__isnull=False

如果只想给特定字段加NULL过滤，也可以单独定义过滤器，比如只给parent字段添加：

from django_filters import filters

class EntityFilter(FilterSet):
    parent = filters.BooleanFilter(field_name='parent', lookup_expr='isnull')
    
    class Meta:
        model = Entity
        fields = '__all__'

这种情况下，过滤方式是/persons/?parent=True（匹配NULL）或/persons/?parent=False（匹配非NULL）。

方案二：临时快速方案（不推荐生产环境） #

如果只是临时测试，不想写FilterSet，可以在ViewSet的get_queryset方法里手动处理参数：

class EntitiesViewSet(viewsets.ModelViewSet):
    # 保留原有基础配置
    queryset = Entity.objects.all()
    serializer_class = EntitiesSerializer
    pagination_class = StandardResultsSetPagination
    filter_backends = (DjangoFilterBackend,)
    filter_fields = '__all__'

    def get_queryset(self):
        queryset = super().get_queryset()
        parent_isnull = self.request.query_params.get('parent__isnull')
        if parent_isnull is not None:
            # 转换参数为布尔值，兼容大小写的字符串输入
            queryset = queryset.filter(parent__isnull=(parent_isnull.lower() == 'true'))
        return queryset

这种方式虽然快，但如果多个字段需要NULL过滤，代码会变得冗余，所以还是推荐方案一。

为什么你之前的尝试无效？ #

• /persons/?parent=null：会精确匹配字符串"null"，而不是数据库中的NULL值
• /persons/?parent=：会匹配空字符串，和NULL是数据库中两个不同的概念
• /persons/?parent__isnull：没有传递具体的布尔值（True/False），DjangoFilterBackend无法识别这个过滤条件

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