如何通过DRF返回自定义状态码？重复创建作业返回202失败排查

你猜的完全正确！问题根源确实是Job模型的unique=True约束被DRF序列化器自动转换成了校验器，在验证阶段就触发了错误，导致你的create方法根本没机会执行。

为什么会这样？ #

DRF的模型序列化器会根据模型字段的约束自动生成对应的校验器，比如当你的name字段设置了unique=True时，序列化器会自动添加UniqueValidator。这个校验是在调用serializer.is_valid()的时候执行的——如果请求中的name已经存在，is_valid()直接返回False，代码会进入else分支返回400，完全不会走到serializer.save()（也就不会调用create方法），所以你写的try-except代码根本没机会运行。

另外，你的代码里还有两个明显的错误需要先修正：

• 序列化器Meta的fields里，('name')要改成('name',)——单元素元组必须加逗号，否则会被当成字符串，DRF会抛出字段匹配错误。
• 序列化器的create方法不能返回Response对象！这个方法的要求是必须返回创建的模型实例，返回Response会直接导致DRF抛出异常。

解决方案 #

我们需要先移除序列化器自动生成的唯一性校验，然后手动处理重复创建的场景，有两种常见的实现方式：

方式一：在视图层提前检查（更直观）

直接在视图的post方法里先查询作业是否存在，存在则直接返回202，否则再走正常的序列化验证流程：

def post(self, request, format=None):
    job_name = request.data.get('name')
    # 先检查作业是否已存在
    if Job.objects.filter(name=job_name).exists():
        return Response({"detail": "该作业已存在"}, status=status.HTTP_202_ACCEPTED)
    
    serializer = CreateJobSerializer(data=request.data)
    if serializer.is_valid():
        serializer.save()
        return Response(serializer.data, status=status.HTTP_201_CREATED)
    else:
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

方式二：在序列化器中捕获异常（更符合DRF流程）

先移除自动生成的UniqueValidator，然后在create方法中捕获唯一性冲突的异常，再在视图层处理返回状态：

1. 修改序列化器：

from django.db import IntegrityError
from rest_framework import serializers

class CreateJobSerializer(GenericSerializer):
    # 移除自动生成的UniqueValidator
    name = serializers.CharField(validators=[])
    
    class Meta:
        model = Job
        fields = ('name',)  # 注意这里的逗号
    
    def create(self, validated_data):
        try:
            return Job.objects.create(**validated_data)
        except IntegrityError as e:
            # 只捕获唯一性约束导致的异常
            if 'unique constraint' in str(e).lower():
                raise serializers.ValidationError("该作业已存在")
            # 其他异常正常抛出
            raise

2. 修改视图的post方法：

def post(self, request, format=None):
    serializer = CreateJobSerializer(data=request.data)
    if serializer.is_valid():
        try:
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        except serializers.ValidationError as e:
            return Response(e.detail, status=status.HTTP_202_ACCEPTED)
    else:
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

总结 #

核心思路就是绕开DRF自动的唯一性校验，把重复场景的控制权拿到自己手里，同时修正代码里的语法和逻辑错误，这样就能实现“作业已存在时返回202”的需求了。

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