Django REST API中@api_view装饰器失效，POST方法直接定义正常

问题现象 #

• 继承APIView的CartItemViews类中，用@api_view(['POST'])装饰post_cart方法时，执行以下POST请求无法触发该方法：

curl -X POST -H "Content-Type: application/json" http://127.0.0.1:8000/api/cart-items/ -d "{\"product_name\":\"name\",\"product_price\":\"41\",\"product_quantity\":\"1\"}"

• 改用@api_view(['GET'])装饰时，收到错误响应：

{
    "detail": "Method \"POST\" not allowed."
}

• 直接将方法名改为post（去掉@api_view装饰器）后，相同的POST请求可成功执行，返回响应：

{
    "status": "success",
    "data": {
        "id": 5,
        "product_name": "item",
        "product_price": 12.5,
        "product_quantity": 5
    }
}

相关代码 #

CartItemViews类代码 #

from django.shortcuts import render
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .serializers import CartItemSerializer
from .models import CartItem
from django.shortcuts import get_object_or_404
from rest_framework.decorators import api_view

class CartItemViews(APIView):
    @api_view(['POST'])
    def post_cart(self,request):
        serializer = CartItemSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response({"status": "success", "data": serializer.data}, status=status.HTTP_200_OK)
        else:
            return Response({"status": "error", "data": serializer.errors}, status=status.HTTP_400_BAD_REQUEST)
    
    def get(self,request, id=None):
        if id:
            item = CartItem.objects.get(id=id)
            serializer = CartItemSerializer(item)
            return Response({"status": "success", "data": serializer.data}, status=status.HTTP_200_OK)
        items = CartItem.objects.all()
        serializer = CartItemSerializer(items, many=True)
        return Response({"status": "success", "data": serializer.data}, status=status.HTTP_200_OK)

    def patch(self,request, id=None):
        if id:
            item = CartItem.objects.get(id=id)
            serializer = CartItemSerializer(item,data=request.data,partial=True)
            if serializer.is_valid():
               serializer.save()
               return Response({"status": "success", "data": serializer.data})
            else:
               return Response({"status": "error", "data": serializer.errors})

    def delete(self, request, id=None):
        item = get_object_or_404(CartItem, id=id)
        item.delete()
        return Response({"status": "success", "data": "Item Deleted"})

urls.py配置代码 #

from django.urls import path
from .views import CartItemViews

urlpatterns = [
    path('cart-items/',CartItemViews.as_view()),
    path('cart-items/<int:id>', CartItemViews.as_view()),
]

原因分析 #

@api_view是专门给函数视图用的装饰器，不能直接用来装饰APIView类中的方法。

APIView的运行逻辑是：根据请求的HTTP方法（如POST、GET），自动匹配类中对应的同名方法（如post()、get()）。你定义的post_cart不是标准HTTP方法名，加上@api_view后，DRF路由系统依然会找类里的post()方法处理POST请求，找不到就返回方法不允许的错误。

解决方案 #

方案1：使用标准方法名（推荐） #

直接把post_cart重命名为post，去掉@api_view装饰器，完全遵循APIView的规范：

class CartItemViews(APIView):
    def post(self,request):  # 修改为标准post方法名
        serializer = CartItemSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response({"status": "success", "data": serializer.data}, status=status.HTTP_200_OK)
        else:
            return Response({"status": "error", "data": serializer.errors}, status=status.HTTP_400_BAD_REQUEST)
    
    # 其他方法保持不变...

方案2：保留自定义方法名（不推荐） #

如果一定要用post_cart作为方法名，可在urls.py中通过as_view()的参数，手动将POST请求映射到该方法，无需@api_view装饰器：

# urls.py
from django.urls import path
from .views import CartItemViews

urlpatterns = [
    path('cart-items/', CartItemViews.as_view({'post': 'post_cart'})),
    path('cart-items/<int:id>', CartItemViews.as_view()),
]

这种方式虽然能实现需求，但会破坏类视图的统一性，不建议在复杂场景中使用。

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