DRF序列化器验证异常：album_data未出现在validated_data中

可能的原因及修复方案 #

1. 序列化器未正确声明album_data字段 #

要确保序列化器里明确定义了album_data字段，且类型匹配提交的嵌套JSON结构：

• 如果是任意结构的嵌套JSON，用JSONField：

class AlbumSerializer(serializers.ModelSerializer):
    album_data = serializers.JSONField(required=True)
    files = serializers.ListField(child=serializers.FileField())

    class Meta:
        model = Album
        fields = ['album_data', 'files']

• 如果album_data是固定结构的嵌套对象，用嵌套序列化器（更严谨）：

class AlbumDataSerializer(serializers.Serializer):
    title = serializers.CharField()
    description = serializers.CharField(required=False)
    category = serializers.CharField()

class AlbumSerializer(serializers.ModelSerializer):
    album_data = AlbumDataSerializer()
    files = serializers.ListField(child=serializers.FileField())

    class Meta:
        model = Album
        fields = ['album_data', 'files']

2. album_data的提交格式错误 #

因为是带文件的表单请求，嵌套JSON不能直接以对象形式提交，必须转为JSON字符串：

• Postman操作：在form-data的album_data字段值中，粘贴格式化后的JSON字符串（比如{"title":"旅行相册","category":"风景"}），而非直接编辑JSON键值对。

3. 自定义验证逻辑误删字段 #

检查序列化器中是否有validate_album_data或全局validate方法，是否在验证后未返回字段值：

# 错误示例：未返回value导致字段丢失
def validate_album_data(self, value):
    if not value.get('title'):
        raise serializers.ValidationError("标题不能为空")
    # 缺少return value！

修复：确保验证方法最后返回处理后的字段值：

def validate_album_data(self, value):
    if not value.get('title'):
        raise serializers.ValidationError("标题不能为空")
    return value

4. 视图未完整传递请求数据 #

即使视图能拿到数据，也要确认序列化器接收的是完整的request.data：

# 正确的自定义视图写法
class AlbumCreateView(APIView):
    def post(self, request):
        serializer = AlbumSerializer(data=request.data)
        # 开启异常抛出，直接定位验证错误
        if serializer.is_valid(raise_exception=True):
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

5. 验证失败未触发报错 #

如果album_data设置了required=False，DRF会在验证失败时静默忽略该字段。可以通过打印serializer.errors查看具体错误，或者在验证时开启raise_exception=True强制抛出异常，快速定位问题。

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