使用ModelSerializer实现关联模型存在性校验的问题

方案1：读写分离字段（推荐） #

这是DRF官方推荐的处理方式，通过定义两个字段分别负责序列化输出和写入校验：

class SongSerializer(serializers.ModelSerializer):
    # 序列化时返回Artist的详细信息，只读
    artist = ArtistSerializer(read_only=True)
    # 写入时接收Artist的ID，自动校验该ID对应的Artist是否存在
    artist_id = serializers.PrimaryKeyRelatedField(
        queryset=Artist.objects.all(),
        source='artist',  # 关联到Song模型的artist外键字段
        write_only=True
    )
    name = serializers.CharField()

    class Meta:
        model = Song
        fields = ['name', 'artist', 'artist_id']

优势： #

• 无需自定义校验逻辑，DRF的PrimaryKeyRelatedField会自动校验ID对应的Artist是否存在，不存在时直接抛出ValidationError
• 序列化输出和写入逻辑完全分离，代码简洁规范，符合DRF的设计理念
• 前端请求时只需传入artist_id字段，序列化返回时自动带出完整的Artist信息

方案2：自定义字段实现单字段读写逻辑 #

如果希望保持单个artist字段，可自定义一个字段类，分别处理写入时的存在性校验和序列化时的详细信息输出：

class ArtistExistsField(serializers.Serializer):
    id = serializers.IntegerField(required=True)

    def to_internal_value(self, data):
        # 写入时校验ID对应的Artist存在
        try:
            return Artist.objects.get(id=data['id'])
        except KeyError:
            raise serializers.ValidationError("Artist ID is required")
        except Artist.DoesNotExist:
            raise serializers.ValidationError("Specified Artist not found")

    def to_representation(self, value):
        # 序列化时用ArtistSerializer输出详细信息
        return ArtistSerializer(value).data

class SongSerializer(serializers.ModelSerializer):
    artist = ArtistExistsField()
    name = serializers.CharField()

    class Meta:
        model = Song
        fields = ['name', 'artist']

优势： #

• 保持字段名统一，前端无需区分artist和artist_id
• 完全自定义读写逻辑，灵活度高

为什么你的原有方案不生效？ #

• 使用ArtistSerializer作为字段时，DRF默认会将其视为嵌套序列化，自动尝试创建/更新关联的Artist实例
• 设置read_only=True后，该字段会被排除在写入处理流程外，因此自定义的validate_artist不会被触发
• 给ArtistSerializer传入validators参数只会添加额外校验，无法跳过其自身的字段校验逻辑

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