DRF序列化器如何处理基于关联表非主键字段的外键间接引用

原实现合理性与缺陷 #

你当前的实现功能上可以满足需求，但存在几个明显的可优化点：

• 重复造轮子：不需要自定义RelatedField，DRF本身提供了专门处理这类场景的内置字段
• 异常处理缺失：直接调用State.objects.get()如果找不到对应flag的记录，会抛出未捕获的DoesNotExist异常，直接返回500服务错误，而不是符合规范的400参数错误
• 缺少基础校验逻辑：自定义字段没有对输入的flag值做类型校验，传入非整数参数时会直接报错，不会触发序列化器的常规校验流程

更简洁的标准实现 #

直接使用DRF内置的SlugRelatedField即可，这是专门为「通过关联表的指定唯一字段做外键读写」设计的字段，代码如下：

class ThingSerializer(serializers.ModelSerializer):
    # 如果希望输入输出的字段名是state_flag就用这个定义
    state_flag = serializers.SlugRelatedField(
        slug_field='flag',
        queryset=State.objects.all(),
        source='state'
    )

    class Meta:
        model = Thing
        exclude = ['state'] # 排除原生的state外键字段，不会对外暴露state_key
        fields = ['thing_key', 'state_flag', ...其余你需要暴露的字段]

如果可以接受输入输出的字段名为state，代码还可以更短：

class ThingSerializer(serializers.ModelSerializer):
    state = serializers.SlugRelatedField(
        slug_field='flag',
        queryset=State.objects.all()
    )

    class Meta:
        model = Thing
        exclude = ['state_key']

这个实现完全满足你的两个需求：

1. 创建实例时仅需要传入flag值，不需要感知state_key的存在
2. 返回结果中不会出现state_key字段，仅返回对应的flag值
   同时自带完整的参数校验能力，参数类型错误、flag不存在时都会自动返回规范的400错误提示，不需要自己写额外的校验逻辑。

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