Django REST Framework可浏览API表单异常：PUT/POST表单同时显示

你遇到的问题根源在于：同时继承ListCreateAPIView和RetrieveUpdateAPIView会导致视图集的allowed_methods合并了两个类的HTTP方法规则，DRF的可浏览API渲染器会基于视图集整体允许的方法来渲染表单，而不是当前路由对应的动作方法，所以两个页面都会显示所有类型的表单。

下面提供两种简洁且符合DRF最佳实践的修复方案：

方案一：GenericViewSet + 目标Mixin（灵活定制动作） #

这种方式适合你需要只保留部分CRUD动作的场景，通过混入对应Mixin来精确控制视图集支持的动作：

from rest_framework import viewsets, mixins
from .models import PublicProfile
from .serializers import (
    PublicProfileReadSerializer,
    PublicProfileCreateSerializer,
    PublicProfileUpdateSerializer
)

class PublicProfileViewSet(
    viewsets.GenericViewSet,
    mixins.ListModelMixin,       # 提供列表查询（GET）动作
    mixins.CreateModelMixin,     # 提供创建资源（POST）动作
    mixins.RetrieveModelMixin,   # 提供单个资源查询（GET）动作
    mixins.UpdateModelMixin      # 提供更新（PUT）和部分更新（PATCH）动作
):
    queryset = PublicProfile.objects.all()

    def get_serializer_class(self):
        # 根据当前动作返回对应的序列化器
        if self.action in ['list', 'retrieve']:
            return PublicProfileReadSerializer
        elif self.action == 'create':
            return PublicProfileCreateSerializer
        elif self.action in ['update', 'partial_update']:
            return PublicProfileUpdateSerializer
        return super().get_serializer_class()

方案二：ModelViewSet（简洁完整CRUD） #

如果你需要完整的CRUD能力，ModelViewSet已经内置了所有必要的Mixin，直接继承后重写序列化器选择逻辑即可：

from rest_framework import viewsets
from .models import PublicProfile
from .serializers import (
    PublicProfileReadSerializer,
    PublicProfileCreateSerializer,
    PublicProfileUpdateSerializer
)

class PublicProfileViewSet(viewsets.ModelViewSet):
    queryset = PublicProfile.objects.all()
    # 默认序列化器，用于列表和详情查询
    serializer_class = PublicProfileReadSerializer

    def get_serializer_class(self):
        if self.action == 'create':
            return PublicProfileCreateSerializer
        elif self.action in ['update', 'partial_update']:
            return PublicProfileUpdateSerializer
        # 其他动作使用默认序列化器
        return super().get_serializer_class()

为什么之前的ViewSet方式没有生成表单？ #

viewsets.ViewSet是最基础的视图集类，它没有内置序列化器关联和可浏览API的表单生成逻辑，必须手动配置serializer_class或者在每个动作方法中处理表单渲染逻辑。而上面两种方案基于GenericViewSet，可以复用DRF的内置逻辑自动生成对应页面的表单，效率更高。

效果验证 #

使用上述任意一种方案后：

• 访问列表URL（http://localhost:8000/api/v1/public_profiles/）时，仅显示POST创建表单
• 访问单个资源URL（如http://localhost:8000/api/v1/public_profiles/123456/）时，仅显示PUT/PATCH更新表单

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