Django中使用PUT/PATCH方法批量更新并返回多对象：解决MultipleObjectsReturned错误

你遇到的MultipleObjectsReturned错误，核心原因是**generics.UpdateAPIView是专门为单对象更新设计的**。它内部的get_object()方法会通过你设置的lookup_field="spec_id"调用Specification.objects.get(spec_id=xxx)，而当数据库中存在多条相同spec_id的记录时，get()方法就会抛出这个错误——因为它要求必须返回且仅返回一个对象。

你的需求是批量更新所有对应spec_id的记录，这和UpdateAPIView的单对象定位逻辑完全不匹配，所以得调整实现方式。

下面提供两种可行的实现方案，你可以根据自己的需求选择：

方案一：重写UpdateAPIView的update方法 #

如果想保留基于通用视图的结构，可以重写update方法，跳过单对象查询的步骤，直接批量处理：

from rest_framework.response import Response
from rest_framework import status

class SpecificationUpdateAPIView(BaseAuthenticationMixin, generics.UpdateAPIView):
    serializer_class = SpecificationAdminSerializer
    permission_classes = [IsAdminUser]
    # 这里不再需要lookup_field，因为我们要批量查询
    queryset = Specification.objects.all()

    def update(self, request, *args, **kwargs):
        # 获取url中的spec_id参数
        spec_id = kwargs.get('spec_id')
        # 过滤出所有对应spec_id的记录
        queryset = self.get_queryset().filter(spec_id=spec_id)
        
        if not queryset.exists():
            return Response({"detail": "No records found for this spec_id."}, status=status.HTTP_404_NOT_FOUND)
        
        # 批量更新value字段
        update_data = request.data
        queryset.update(**update_data)
        
        # 序列化并返回更新后的所有记录
        serializer = self.get_serializer(queryset, many=True)
        return Response(serializer.data)

方案二：改用APIView完全自定义逻辑 #

如果需要更灵活的控制（比如区分PUT和PATCH的不同行为），直接继承APIView实现会更清晰：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status

class SpecificationBulkUpdateAPIView(BaseAuthenticationMixin, APIView):
    permission_classes = [IsAdminUser]
    serializer_class = SpecificationAdminSerializer

    def put(self, request, spec_id):
        # PUT要求替换整个资源，这里我们统一更新指定字段（和需求匹配）
        return self._bulk_update(request, spec_id)
    
    def patch(self, request, spec_id):
        # PATCH做部分更新，和PUT逻辑一致，这里复用同一个方法
        return self._bulk_update(request, spec_id)
    
    def _bulk_update(self, request, spec_id):
        queryset = Specification.objects.filter(spec_id=spec_id)
        if not queryset.exists():
            return Response({"detail": "No records found for this spec_id."}, status=status.HTTP_404_NOT_FOUND)
        
        # 验证请求数据（可选，确保传入的字段合法）
        serializer = self.serializer_class(data=request.data, partial=True)
        if serializer.is_valid(raise_exception=True):
            queryset.update(**serializer.validated_data)
            # 返回更新后的记录
            updated_records = Specification.objects.filter(spec_id=spec_id)
            response_serializer = self.serializer_class(updated_records, many=True)
            return Response(response_serializer.data)

同时，记得修改urls.py中的视图类名（如果用方案二的话）：

path( "api/specification/<int:spec_id>/", views.SpecificationBulkUpdateAPIView.as_view(), name="specification-bulk-update-view", )

• 序列化器的调整：因为现在要处理多个对象，所以在序列化时需要加上many=True参数。
• 数据验证：方案二中加入了序列化器验证，确保请求的数据符合模型字段的要求，避免非法数据入库。
• HTTP方法语义：PUT通常表示替换整个资源，PATCH表示部分更新，不过你的需求是更新指定字段，所以两种方法可以复用同一逻辑，如果你需要严格区分语义，可以在put方法中要求传入所有必填字段。

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