如何在Django Rest Framework中让无参数端点请求返回Bad Request

针对你需要的「未携带有效foo_id参数时返回指定格式400响应」的需求，以下是几种直接可行的实现方式：

方式1：在APIView的GET方法中直接校验 #

如果你的视图是基于APIView编写的，可直接在get方法开头做参数校验：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import FooModel
from .serializers import FooSerializer

class FooView(APIView):
    def get(self, request):
        foo_id = request.query_params.get('foo_id')
        # 校验参数是否存在且非空
        if not foo_id or foo_id.strip() == '':
            return Response(
                {"status": 400, "error": "Bad Request"},
                status=status.HTTP_400_BAD_REQUEST
            )
        # 执行正常过滤逻辑
        queryset = FooModel.objects.filter(id=foo_id)
        serializer = FooSerializer(queryset, many=True)
        return Response(serializer.data)

方式2：用序列化器规范校验查询参数 #

这种方式更符合DRF的设计规范，通过自定义序列化器校验查询参数：

from rest_framework import serializers
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import FooModel
from .serializers import FooSerializer

# 定义查询参数校验序列化器
class FooQuerySerializer(serializers.Serializer):
    foo_id = serializers.CharField(required=True, error_messages={
        'required': 'Bad Request',
        'blank': 'Bad Request'
    })

class FooView(APIView):
    def get(self, request):
        serializer = FooQuerySerializer(data=request.query_params)
        if not serializer.is_valid():
            return Response(
                {"status": 400, "error": "Bad Request"},
                status=status.HTTP_400_BAD_REQUEST
            )
        # 从校验通过的参数中取值
        foo_id = serializer.validated_data['foo_id']
        queryset = FooModel.objects.filter(id=foo_id)
        serializer = FooSerializer(queryset, many=True)
        return Response(serializer.data)

方式3：针对GenericAPIView/ViewSet的场景 #

如果使用的是GenericAPIView或ViewSet，可以重写initial方法提前做全局校验：

from rest_framework.generics import ListAPIView
from rest_framework.response import Response
from rest_framework import status
from .models import FooModel
from .serializers import FooSerializer

class FooListView(ListAPIView):
    serializer_class = FooSerializer

    def initial(self, request, *args, **kwargs):
        super().initial(request, *args, **kwargs)
        foo_id = request.query_params.get('foo_id')
        if not foo_id or foo_id.strip() == '':
            return Response(
                {"status": 400, "error": "Bad Request"},
                status=status.HTTP_400_BAD_REQUEST
            )

    def get_queryset(self):
        foo_id = self.request.query_params.get('foo_id')
        return FooModel.objects.filter(id=foo_id)

关键注意事项 #

• 必须同时校验「参数不存在」和「参数为空字符串」两种情况，覆盖get_foo/?foo_id=这类无效请求
• 确保响应格式严格匹配要求：{"status": 400, "error": "Bad Request"}
• 若使用DjangoFilterBackend等过滤组件，也要先做参数校验，避免无参数时返回全量数据

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