如何在DRF中通过单个API批量保存多员工Standup对象列表？

1. 修改序列化器支持批量处理 #

默认ModelSerializer不支持批量创建，需开启many=True选项，并通过重写create方法使用bulk_create提升入库效率（减少数据库操作次数）。

修改后的序列化器代码：

class StandupSerializer(serializers.ModelSerializer):
    class Meta:
        model = Standup
        fields = '__all__'

    def create(self, validated_data):
        # 处理批量数据
        if isinstance(validated_data, list):
            return Standup.objects.bulk_create([Standup(**item) for item in validated_data])
        # 兼容单条数据创建
        return super().create(validated_data)

2. 重写视图集的create方法 #

ModelViewSet默认create方法仅支持单对象处理，需修改为能识别列表格式请求数据，并调用序列化器的批量逻辑。

修改后的视图集代码：

from rest_framework import status
from rest_framework.response import Response

class StandupDetail(viewsets.ModelViewSet):
    queryset = Standup.objects.all()
    serializer_class = StandupSerializer

    def create(self, request, *args, **kwargs):
        # 判断请求数据是否为列表
        is_bulk_request = isinstance(request.data, list)
        # 传入many=True启用批量序列化验证
        serializer = self.get_serializer(data=request.data, many=is_bulk_request)
        serializer.is_valid(raise_exception=True)
        self.perform_create(serializer)
        headers = self.get_success_headers(serializer.data)
        return Response(serializer.data, status=status.HTTP_201_CREATED, headers=headers)

    def perform_create(self, serializer):
        # 兼容单条和批量的保存逻辑
        serializer.save()

3. 批量请求的数据格式示例 #

发送POST请求时，需以JSON数组格式传递数据，每个元素对应一个Standup对象：

[
    {
        "team": 1,
        "employee": 2,
        "status": "in_progress",
        "work_done_yesterday": "完成用户列表接口开发",
        "work_to_do": "调试支付模块",
        "blockers": "暂无"
    },
    {
        "team": 2,
        "employee": 2,
        "status": "completed",
        "work_done_yesterday": "修复团队权限bug",
        "work_to_do": "编写团队管理接口文档",
        "blockers": "需要产品确认需求细节"
    }
]

4. 关键注意事项 #

• 确保请求的Content-Type设置为application/json，否则Django无法正确解析列表格式数据。
• bulk_create不会触发模型的save方法和post_save等信号，若有相关业务逻辑需手动处理。
• 可添加权限验证逻辑，限制仅有权限的用户提交批量数据。
• 模型中auto_now_add=True的字段（standup_time、update_time）会自动设置为当前时间，无需手动传入。

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