Django REST Framework自定义POST动作无需序列化器的实现问题

我在使用Django REST Framework（DRF）开发时，在ModelViewSet中实现了一个取消订单的自定义动作（通过@action装饰器）。该动作仅需修改数据库状态并返回响应，完全不需要使用序列化器，但设置serializer_class = None并未达到预期效果。

我的ViewSet代码如下：

from rest_framework import viewsets, status
from rest_framework.decorators import action
from rest_framework.response import Response
from rest_framework.permissions import IsAuthenticated

class OrderViewSet(ModelViewSet):
    http_method_names = ['get', 'post', 'patch', 'delete', 'head', 'options']

    @action(detail=True, methods=['post'], permission_classes=[IsAuthenticated], serializer_class=None) # 此处设置无效
    def cancel(self, request, pk=None):
        order = self.get_object()
        OrderService.cancel_order(order, request.user)
        return Response({'status': 'Order cancelled'}, status=status.HTTP_200_OK)

    def get_serializer_class(self):
        if self.action == 'cancel':
            return None  # 会触发'NoneType' object is not callable错误
        # if self.action == 'cancel':
        #     return EmptySerializer # 此方式可行但冗余
        if self.request.method == 'POST':
            return CreateOrderSerializer
        elif self.request.method == 'PATCH':
            return UpdateOrderSerializer
        return OrderSerializer

遇到的问题 #

• 在@action装饰器内设置serializer_class=None无效
• 在get_serializer_class中返回None会引发'NoneType' object is not callable错误

目前我通过创建空序列化器EmptySerializer绕过DRF的要求，但觉得这种方式冗余，想寻求更优的解决方法。

优化解决方案 #

方案1：使用DRF自带的空序列化器替代自定义空类

无需单独创建EmptySerializer，直接在get_serializer_class中返回DRF内置的serializers.Serializer（本身就是无字段的空序列化器）：

from rest_framework import serializers

class OrderViewSet(ModelViewSet):
    # ... 其他代码不变

    def get_serializer_class(self):
        if self.action == 'cancel':
            return serializers.Serializer  # 使用DRF自带的空序列化器
        if self.request.method == 'POST':
            return CreateOrderSerializer
        elif self.request.method == 'PATCH':
            return UpdateOrderSerializer
        return OrderSerializer

方案2：重写get_serializer方法跳过序列化器初始化

如果不想依赖任何序列化器，可以重写ViewSet的get_serializer方法，当动作是cancel时返回一个空的序列化器实例，避免DRF尝试初始化不存在的序列化器：

from rest_framework import serializers

class OrderViewSet(ModelViewSet):
    # ... 其他代码不变

    def get_serializer(self, *args, **kwargs):
        if self.action == 'cancel':
            return serializers.Serializer(*args, **kwargs)
        return super().get_serializer(*args, **kwargs)

    def get_serializer_class(self):
        if self.request.method == 'POST':
            return CreateOrderSerializer
        elif self.request.method == 'PATCH':
            return UpdateOrderSerializer
        return OrderSerializer

方案3：直接在自定义动作中忽略序列化器逻辑

由于cancel动作不需要解析请求体，只要不在方法内调用self.get_serializer()或相关序列化器方法，DRF不会强制要求序列化器存在。此时只需确保get_serializer_class不为cancel动作返回None，而是返回一个合法的序列化器类（比如serializers.Serializer）即可，这样既满足DRF的内部校验，又无需额外代码。

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