如何在Django-Rest-Framework中对unique_together约束返回400错误？

嗨，这个问题我之前也碰到过！DRF 默认确实不会把数据库的 unique_together 冲突转换成友好的 400 响应，不过有两种靠谱的解决方式，咱们一步步来：

这种方式能在请求到达数据库之前就拦截重复数据，不仅更高效，还能返回精准的字段级错误提示，用户体验更好。

步骤说明： #

1. 把当前请求的用户传递给序列化器的 context，这样序列化器就能拿到 owner 字段的值；
2. 在序列化器的 validate 方法中，结合当前用户和其他字段，检查是否违反 unique_together 约束；
3. 如果存在冲突，直接抛出 ValidationError，DRF 会自动返回 400 响应。

代码示例： #

假设你的模型是这样的：

from django.db import models
from django.contrib.auth.models import User

class YourModel(models.Model):
    owner = models.ForeignKey(User, on_delete=models.CASCADE)
    other_field = models.CharField(max_length=100)

    class Meta:
        unique_together = ('owner', 'other_field')

序列化器代码：

from rest_framework import serializers
from .models import YourModel

class YourModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = YourModel
        fields = ['id', 'other_field']  # owner 由后端自动设置，不暴露给客户端

    def validate(self, data):
        # 从 context 中获取当前请求的用户
        current_user = self.context['request'].user
        target_field = data.get('other_field')

        # 检查是否已经存在相同的 owner + other_field 组合
        if YourModel.objects.filter(owner=current_user, other_field=target_field).exists():
            raise serializers.ValidationError({
                'other_field': f"你已经拥有一条 {target_field} 的记录了，不能重复创建！"
            })
        return data

视图代码（以 CreateAPIView 为例）：

from rest_framework.generics import CreateAPIView
from .serializers import YourModelSerializer

class YourModelCreateView(CreateAPIView):
    serializer_class = YourModelSerializer

    def perform_create(self, serializer):
        # 把当前用户设置为 owner 字段
        serializer.save(owner=self.request.user)

    # 确保序列化器能拿到 request 对象
    def get_serializer_context(self):
        context = super().get_serializer_context()
        context['request'] = self.request
        return context

如果遇到高并发场景，可能出现「验证通过但保存时数据库已存在重复数据」的竞态问题，这时候就需要捕获数据库抛出的异常，转换成 400 响应。

方式1：在视图中单独处理 #

from django.db import IntegrityError
from rest_framework.response import Response
from rest_framework import status
from rest_framework.generics import CreateAPIView
from .serializers import YourModelSerializer

class YourModelCreateView(CreateAPIView):
    serializer_class = YourModelSerializer

    def create(self, request, *args, **kwargs):
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)
        try:
            self.perform_create(serializer)
        except IntegrityError as e:
            # 可以根据异常信息进一步判断是否是 unique_together 导致的
            if 'unique constraint' in str(e).lower():
                return Response(
                    {'detail': "该记录组合已存在，无法重复创建！"},
                    status=status.HTTP_400_BAD_REQUEST
                )
            # 其他 IntegrityError 按原逻辑处理
            raise e
        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(owner=self.request.user)

方式2：全局异常处理器（通用所有视图） #

如果想让所有视图都自动处理这类异常，可以写一个全局异常处理器：

# 在你的 app 下创建 exceptions.py
from rest_framework.views import exception_handler
from django.db import IntegrityError
from rest_framework.response import Response
from rest_framework import status

def custom_exception_handler(exc, context):
    # 先调用 DRF 默认的异常处理器
    response = exception_handler(exc, context)

    # 捕获 unique_together 导致的 IntegrityError
    if isinstance(exc, IntegrityError):
        if 'unique constraint' in str(exc).lower():
            return Response(
                {'detail': "该数据组合已存在，不能重复创建！"},
                status=status.HTTP_400_BAD_REQUEST
            )

    return response

然后在 settings.py 中配置：

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'your_app.exceptions.custom_exception_handler',
}

两种方法对比 #

• 方法一：提前验证，错误信息更精准，性能更好，但无法完全避免高并发下的竞态问题；
• 方法二：捕获数据库异常，能处理竞态场景，但错误信息相对通用，需要解析异常内容。

建议优先使用方法一，再搭配方法二作为兜底，覆盖所有场景。

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