如何为包含ForeignKey字段的DRF Serializer类正确实现create方法

首先明确你当前代码的核心问题：

1. serializers.StringRelatedField 默认为只读字段，仅在序列化输出（返回响应给前端）时调用关联City模型的__str__方法返回值，不会参与反序列化（接收前端提交数据）的解析和校验，所以validated_data中不会包含city字段的值。
2. create方法中错误实例化了Team类，应该实例化你的目标模型Venue。
3. 如果你定义的city是单外键（一个Venue仅关联一个City），StringRelatedField不需要加many=True参数，该参数仅用于多对多、一对多反向关联的场景。

常用解决方案 #

场景1：前端提交关联City的主键ID创建Venue（最常用）

DRF默认对外键字段会使用PrimaryKeyRelatedField，会自动校验传入的ID是否对应存在的City实例，无需你手动处理查询逻辑：

class VenueSerializer(serializers.ModelSerializer):
    # 新增只读字段，返回给前端时展示城市名，不影响反序列化逻辑
    city_name = serializers.StringRelatedField(source='city', read_only=True)
    class Meta:
        model = Venue
        # 按需列出字段，不要随意用__all__暴露不必要的字段
        fields = ['id', 'name', 'city', 'city_name']

    def create(self, validated_data):
        # validated_data中的city已经是DRF校验后生成的City实例，直接创建即可
        return Venue.objects.create(**validated_data)

该场景下前端提交的请求体格式参考：

{
  "name": "XX体育馆",
  "city": 3
}

其中3是关联City实例的主键ID。

场景2：前端提交城市名称创建Venue

如果业务要求前端传城市名而非ID，需要自定义字段处理逻辑：

class VenueSerializer(serializers.ModelSerializer):
    # 定义city为普通字符串字段，接收前端传入的城市名
    city = serializers.CharField(max_length=100)
    class Meta:
        model = Venue
        fields = '__all__'

    def create(self, validated_data):
        # 取出传入的城市名并移除出validated_data
        city_name = validated_data.pop('city')
        # 查找对应的City实例，不存在则抛出校验错误
        try:
            city_instance = City.objects.get(name=city_name)
        except City.DoesNotExist:
            raise serializers.ValidationError("传入的城市不存在")
        # 关联查到的City实例创建Venue
        return Venue.objects.create(city=city_instance, **validated_data)

多对多关联补充说明 #

如果你的Venue和City是多对多关联（即一个Venue可以关联多个City，city字段为ManyToManyField），仅需要在场景2的create方法中稍作调整：

def create(self, validated_data):
    city_names = validated_data.pop('city')
    city_instances = City.objects.filter(name__in=city_names)
    if len(city_instances) != len(city_names):
        raise serializers.ValidationError("存在未录入的城市")
    venue = Venue.objects.create(**validated_data)
    # 多对多关联需要先创建主实例，再添加关联关系
    venue.city.add(*city_instances)
    return venue

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