同一URL配置多个Django通用视图遇方法不允许问题求助

Django的URL路由是从上到下顺序匹配的，同一个URL路径只会触发第一个匹配到的视图，后面的同路径配置完全不会被执行。这就是你遇到的问题：

• 访问/cars/时，只会命中第一个CarListApi，后面的CarCreateApi永远不会被调用；
• 访问/cars/uuid/时，只会命中第一个CarDeleteApi，CarUpdateApi和CarDetailApi都没机会处理请求。
  如果第一个视图不支持对应的HTTP方法（比如CarListApi只处理GET），自然会返回Method Not Allowed。

你不需要修改URL结构，只需要把同一URL路径的不同HTTP方法逻辑整合到同一个视图中，DRF提供了两种简洁的实现方式：

方式1：使用ViewSet（推荐，符合RESTful最佳实践） #

ViewSet可以把列表、创建、详情、更新、删除的逻辑封装在一个类里，通过路由映射不同HTTP方法到对应动作：

修改views.py #

from rest_framework import viewsets, mixins
from rest_framework.permissions import IsOwnerOrReadOnly
from rest_framework import status
from rest_framework.response import Response
from drf_spectacular.utils import extend_schema_serializer, extend_schema
from .models import Car

class CarViewSet(mixins.ListModelMixin,
                 mixins.CreateModelMixin,
                 mixins.RetrieveModelMixin,
                 mixins.UpdateModelMixin,
                 mixins.DestroyModelMixin,
                 viewsets.GenericViewSet):
    permission_classes = (IsOwnerOrReadOnly,)
    lookup_field = 'uuid'
    queryset = Car.objects.all()  # 必须定义queryset，或重写get_queryset方法

    @extend_schema_serializer(component_name="CarSerializer")
    class Serializer(serializers.ModelSerializer):
        class Meta:
            model = Car
            fields = ['plate', 'make', 'model', 'uuid']

    def get_serializer_class(self):
        return self.Serializer

    # 复用自定义的car_update逻辑
    def update(self, request, *args, **kwargs):
        instance = self.get_object()
        serializer = self.get_serializer(instance, data=request.data)
        serializer.is_valid(raise_exception=True)
        car = car_update(serializer.validated_data, instance.uuid)
        return Response(self.get_serializer(car).data, status=status.HTTP_201_CREATED)

    # 复用自定义的car_delete逻辑
    def destroy(self, request, *args, **kwargs):
        instance = self.get_object()
        if car_delete(instance.uuid):
            self.perform_destroy(instance)
            return Response(status=status.HTTP_200_OK)
        return Response(status=status.HTTP_404_NOT_FOUND)

修改urls.py #

可以用DRF的路由自动生成，或者手动映射：

自动路由（推荐）

from rest_framework.routers import DefaultRouter
from .views import CarViewSet

router = DefaultRouter()
router.register(r'', CarViewSet, basename='car')

urlpatterns = router.urls

手动路由

urlpatterns = [
    path('', CarViewSet.as_view({'get': 'list', 'post': 'create'}), name='car-list'),
    path('<uuid:uuid>/', CarViewSet.as_view({'get': 'retrieve', 'put': 'update', 'delete': 'destroy'}), name='car-detail'),
]

方式2：手动合并视图类 #

如果不想用ViewSet，可以把同一URL的多个HTTP方法逻辑合并到单个视图类：

修改views.py #

from rest_framework import generics
from rest_framework.permissions import IsOwnerOrReadOnly
from rest_framework import status
from rest_framework.response import Response
from drf_spectacular.utils import extend_schema_serializer, extend_schema

# 处理 /cars/ 的GET（列表）和POST（创建）
class CarListCreateApi(generics.ListAPIView, generics.CreateAPIView):
    queryset = Car.objects.all()
    serializer_class = CarSerializer  # 复用你的序列化器

# 处理 /cars/uuid/ 的GET（详情）、PUT（更新）、DELETE（删除）
class CarDetailUpdateDeleteApi(generics.RetrieveAPIView, generics.UpdateAPIView, generics.DestroyAPIView):
    permission_classes = (IsOwnerOrReadOnly,)
    lookup_field = 'uuid'
    queryset = Car.objects.all()
    serializer_class = CarSerializer

    # 重写update方法
    def update(self, request, uuid, *args, **kwargs):
        serializer = self.get_serializer(data=request.data, context={'request': request})
        serializer.is_valid(raise_exception=True)
        car = car_update(serializer.validated_data, uuid)
        return Response(self.get_serializer(car).data, status=status.HTTP_201_CREATED)

    # 重写destroy方法
    def destroy(self, request, uuid, *args, **kwargs):
        serializer = self.get_serializer(data=request.data)
        if serializer.is_valid(raise_exception=True) and car_delete(uuid):
            return Response(status=status.HTTP_200_OK)
        return Response(serializer.errors, status=status.HTTP_404_NOT_FOUND)

修改urls.py #

urlpatterns = [
    path('', CarListCreateApi.as_view(), name='car-list-create'),
    path('<uuid:uuid>/', CarDetailUpdateDeleteApi.as_view(), name='car-detail-update-delete'),
]

• 你的CarUpdateApi和CarDeleteApi中http_method_names设置了多余的方法（比如UpdateApi不需要delete、get、post），建议只保留当前视图需要处理的方法，避免混淆；
• 自定义car_update和car_delete函数时，要确保逻辑正确，比如更新时要处理实例存在性检查，删除时要返回正确的状态码。

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