Django REST Framework ListAPIView参数错误/为空时如何返回无数据提示？

你的需求是当请求参数为空、无效，或者过滤后没有匹配数据时，返回“无数据/未找到数据”的结果，当前代码存在两个主要问题：

• 未处理无请求参数的场景，直接返回默认空响应，不符合自定义格式要求
• 未处理参数无效或过滤后无数据的场景，无法统一返回指定提示

以下是修改后的完整代码及说明：

from django_filters.rest_framework import DjangoFilterBackend, filters
from rest_framework import generics
from rest_framework.response import Response

class FilterTablePVPlantByPVOwnerId(filters.FilterSet):
    id = filters.CharFilter(field_name='id', lookup_expr='exact')

    class Meta:
        model = TablePVPlant
        fields = ['id']

class PlantListByClientView(generics.ListAPIView):
    queryset = TablePVPlant.objects.all()
    serializer_class = PlantListSerializer
    filter_backends = [DjangoFilterBackend]
    filterset_class = FilterTablePVPlantByPVOwnerId

    def list(self, request, *args, **kwargs):
        # 先获取过滤后的查询集
        queryset = self.filter_queryset(self.get_queryset())
        
        # 检查请求参数是否合法：只允许FilterSet定义的字段
        allowed_params = set(self.filterset_class.Meta.fields)
        received_params = set(request.query_params.keys())
        invalid_params = received_params - allowed_params
        
        if invalid_params:
            return Response({
                'status': 'fail',
                'data': [],
                'msg': '无效的请求参数'
            }, status=400)
        
        # 处理参数为空或过滤后无数据的情况
        if not request.query_params or not queryset.exists():
            return Response({
                'status': 'success',
                'data': [],
                'msg': '未找到数据'
            })
        
        # 有有效参数且有匹配数据的正常场景
        serializer = self.get_serializer(queryset, many=True)
        return Response({
            'status': 'success',
            'data': serializer.data,
            'msg': 'done'
        })

关键改动说明： #

• 统一过滤逻辑：不管有没有请求参数，先执行过滤操作，避免分支遗漏
• 参数合法性校验：对比请求参数和FilterSet定义的允许字段，存在无效参数时直接返回错误提示
• 无数据场景统一处理：
  • 未传任何参数时，返回“未找到数据”
  • 参数合法但过滤后无匹配数据时，同样返回“未找到数据”
• 统一响应格式：所有场景都返回结构一致的JSON，前端无需适配多种响应格式

补充说明： #

如果不需要严格校验无效参数（允许系统自动忽略未定义的参数），可以直接去掉参数合法性校验的代码块，只保留空值和无匹配数据的处理逻辑即可。

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