Django Rest Framework中外键传None保存序列化器报错问题

我帮你梳理下这个问题的核心原因，主要出在序列化器配置和视图写法上，咱们一步步解决：

问题根源分析 #

1. 嵌套序列化器默认不允许Null值
   你在HeaderSerializer里把features定义为ProjectSerializer()，但DRF的嵌套序列化器默认是必填字段——哪怕你的模型里已经设置了null=True, blank=True，只要序列化器层面没开启允许null的配置，在验证阶段就会直接抛出"This field may not be null."的错误，根本走不到你自定义的create方法逻辑。

2. 视图中序列化器初始化方式错误
   你的视图里写了serializer = HeaderSerializer('features':features)，这是典型的用法错误：DRF序列化器初始化时，必须把待验证的数据放在data参数里，否则序列化器不会正确解析和验证传入的值。

3. create方法的逻辑存在隐患
   当features为None时，你原本的validated_data.pop("features")会因为序列化器验证不通过而根本不会执行；另外，即使验证通过，直接pop而不设置默认值的话，当字段不存在时也会抛出KeyError。

分步解决办法 #

1. 修改HeaderSerializer，允许features字段为Null #

在嵌套序列化器的定义中加上allow_null=True，同时优化create方法的逻辑：

class HeaderSerializer(serializers.ModelSerializer):
    # 关键：给嵌套序列化器加上allow_null=True，允许字段为None
    features = ProjectSerializer(allow_null=True)

    class Meta:
        model = models.Header
        fields = ('id', 'features')

    def create(self, validated_data):
        # 用pop的第二个参数设置默认值，避免字段不存在时抛KeyError
        features_data = validated_data.pop("features", None)
        features = None
        if features_data:
            # 建议加上异常处理，避免传入无效id时崩溃
            try:
                features = models.Project.objects.get(pk=features_data.get("id"))
            except models.Project.DoesNotExist:
                raise serializers.ValidationError({"features": "Project with this id does not exist."})
        # 直接用create方法传入参数，不需要单独调用save()
        obj = models.Header.objects.create(features=features, **validated_data)
        return obj

2. 修正视图中的序列化器初始化代码 #

DRF中推荐用request.data替代request.POST（支持JSON、表单等多种请求格式），同时正确传递data参数：

@api_view(['GET', 'POST', 'DELETE'])
def header_detail_pk(request):
    if request.method == 'POST':
        # 用request.data兼容所有请求格式
        features = request.data.get('features')
        # 正确初始化序列化器：数据必须放在data参数中
        serializer = HeaderSerializer(data={'features': features})
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

3. 可选优化：用PrimaryKeyRelatedField简化外键关联 #

如果你的场景只是关联已有的Project（不需要传递整个Project的嵌套数据），可以把features字段改成PrimaryKeyRelatedField，这样更简洁，也更符合DRF外键关联的常规用法：

class HeaderSerializer(serializers.ModelSerializer):
    features = serializers.PrimaryKeyRelatedField(
        queryset=models.Project.objects.all(),
        allow_null=True,
        required=False  # 允许字段不传入
    )

    class Meta:
        model = models.Header
        fields = ('id', 'features')

    # 此时不需要自定义create方法，DRF默认的create逻辑就能正确处理

这样修改后，当你传入features: null或者完全不传这个字段时，序列化器都会正常验证，并且将features设为Null保存到数据库。

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