Django bulk_create upsert时唯一约束触发序列化器验证错误

问题根源 #

添加subject_variation与exam_results的联合唯一约束后，Django的ModelSerializer会自动生成对应的唯一性验证器。当你调用API执行更新操作时，序列化器会在数据库处理前就检查到该组合已存在，直接抛出"必须为唯一集合"的错误，导致bulk_create的update_conflicts逻辑根本没机会触发。

解决方案 #

核心思路是：让数据库层面处理冲突更新，同时让序列化器跳过不必要的唯一性验证。

步骤1：保留模型的联合唯一约束

这是bulk_create实现upsert（插入或更新）的基础，不能移除：

class Marks(models.Model):
    subject_variation = models.ForeignKey(SubjectVariation, on_delete=models.CASCADE)
    exam_results = models.ForeignKey(ExamResults, on_delete=models.CASCADE)
    marks = models.IntegerField()

    class Meta:
        unique_together = ('subject_variation', 'exam_results')

步骤2：修改序列化器，移除自动生成的唯一性验证器

ModelSerializer会默认给unique_together字段生成验证器，我们需要手动移除它：

from rest_framework import serializers
from .models import Marks

class MarksSerializer(serializers.ModelSerializer):
    class Meta:
        model = Marks
        fields = ['subject_variation', 'exam_results', 'marks']
        # 移除自动生成的unique_together验证器
        validators = []

步骤3：正确调用bulk_create执行upsert

在视图中验证数据后，通过bulk_create的参数指定冲突时的更新逻辑：

from rest_framework.views import APIView
from rest_framework.response import Response
from .serializers import MarksSerializer
from .models import Marks

class BulkMarksAPIView(APIView):
    def post(self, request):
        serializer = MarksSerializer(data=request.data, many=True)
        serializer.is_valid(raise_exception=True)
        
        # 批量执行创建/更新
        Marks.objects.bulk_create(
            [Marks(**item) for item in serializer.validated_data],
            update_conflicts=True,
            # 指定用于判断冲突的唯一字段（和模型约束一致）
            unique_fields=['subject_variation', 'exam_results'],
            # 指定冲突时需要更新的字段
            update_fields=['marks'],
        )
        
        return Response({"status": "success"})

补充说明 #

• 该方案依赖Django 4.0+的update_conflicts参数，且要求数据库支持UPSERT语法（如PostgreSQL、MySQL 8.0+）。
• 如果需要在纯创建场景下保留唯一性验证，可以自定义validate方法，仅在无实例时检查：

  def validate(self, data):
      # 仅当创建新记录时检查唯一性
      if not self.instance:
          if Marks.objects.filter(
              subject_variation=data['subject_variation'],
              exam_results=data['exam_results']
          ).exists():
              raise serializers.ValidationError("subject_variation, exam_results必须为唯一集合")
      return data
  

  注意：这种写法不适用于混合创建和更新的批量场景，此时建议直接用步骤2的方案，让数据库统一处理冲突。

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