Django REST Framework如何允许提交空的可选字段数据不返回400错误

问题根因 #

你遇到的400报错主要由两个核心问题导致：

1. 模型字段约束不匹配：IntegerField仅设置blank=True仅表示表单层允许为空，数据库层面仍默认不允许存储NULL值，提交空数据时类型转换/存储校验会失败
2. 视图层赋值逻辑不规范：直接修改序列化器initial_data的操作不符合DRF设计规范，可能导致校验逻辑异常

修复方案 #

第一步：修正模型字段约束 #

给需要允许为空的数字类型字段加上null=True，保证数据库层面允许存储空值：

# models.py
class Product(models.Model):
    name = models.CharField(max_length=50)
    description = models.TextField(blank=True)
    price = models.FloatField()
    # 新增null=True，数字类型字段要允许空必须同时设置blank和null
    quantity = models.IntegerField(blank=True, null=True)
    user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
    shop = models.ForeignKey(Shop, on_delete=models.DO_NOTHING)
    discount = models.FloatField(default=0)

修改后需要执行python manage.py makemigrations和python manage.py migrate同步数据库结构。

第二步：调整序列化器配置 #

明确指定可选字段的校验规则，避免序列化器默认校验拦截空值提交：

# serializer.py
class ProductSerializer(serializers.ModelSerializer):
    # 显式设置user字段为只读，不需要前端传入
    user = serializers.PrimaryKeyRelatedField(read_only=True)
    class Meta:
        model = Product
        fields = '__all__'
        # 批量指定可选字段，无需逐个声明
        extra_kwargs = {
            'quantity': {'required': False, 'allow_null': True},
            'description': {'required': False},
            'discount': {'required': False}
        }

第三步：修正视图层赋值逻辑 #

不要直接修改initial_data，改为在序列化器保存时传入自动填充的字段值：

# views.py
def products(request):
    if request.method == 'GET':
        products = Product.objects.filter(user=request.user)
        serializer = ProductSerializer(products, many=True)
        return Response(serializer.data)

    elif request.method == 'POST':
        serializer = ProductSerializer(data=request.data)
        if serializer.is_valid():
            # 保存时传入user字段，比修改initial_data更安全合规
            serializer.save(user=request.user)
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

约束规则说明 #

• blank=True：控制Django表单/DRF序列化器层是否允许传入空字符串，适用于字符串类型字段
• null=True：控制数据库层面是否允许存储NULL值，数字、日期等非字符串类型字段要允许为空必须同时设置blank=True和null=True
• 序列化器的required=False表示前端可以不传入该字段，会自动使用模型的默认值/NULL填充

额外提示：如果前端习惯传空字符串代表未填写，可在序列化器中重写to_internal_value方法，自动将数字类型字段的空字符串转换为None，避免类型校验报错。

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