Django DRF Generic Relations：如何从API响应中获取content_object字段

核心问题：你已经定义了适配泛型关联的ContentObjectRelatedField自定义字段，但没有在DocumentSerializer中声明绑定到content_object属性，DRF默认不会自动序列化GenericForeignKey类型的虚拟字段，所以直接把字段名加到fields列表会报错。

第一步：修改DocumentSerializer #

在序列化器中显式声明content_object字段使用你自定义的序列化逻辑：

class DocumentSerializer(serializers.ModelSerializer):
    # 绑定自定义字段到content_object属性
    content_object = ContentObjectRelatedField(read_only=True)

    class Meta:
        model = Document
        fields = ('id', 'title', 'content_type',
                  'object_id', 'category', 'content_object') # 新增字段到返回列表

提示：如果业务中允许content_object为空（你的模型里content_type和object_id都是null=True），可以把字段声明改为content_object = ContentObjectRelatedField(read_only=True, allow_null=True)，同时在to_representation方法开头添加if value is None: return None避免报错。

第二步：处理循环导入问题 #

如果你的FolderSerializer、CollectionSerializer和DocumentSerializer存在互相引用导致导入报错，可以把序列化器导入移到to_representation方法内部实现延迟导入：

class ContentObjectRelatedField(serializers.RelatedField):
    def to_representation(self, value):
        if value is None:
            return None
        # 方法内导入避免循环依赖
        from .serializers import FolderSerializer, CollectionSerializer
        if isinstance(value, Folder):
            serializer = FolderSerializer(value)
        elif isinstance(value, Collection):
            serializer = CollectionSerializer(value)
        else:
            raise Exception('Unexpected type of object')
        return serializer.data

如果不需要返回关联对象的完整字段，也可以简化序列化逻辑避免引用其他序列化器：

def to_representation(self, value):
    if value is None:
        return None
    return {
        "type": value.__class__.__name__,
        "id": value.id,
        "title": str(value)
    }

第三步：优化查询性能（可选但推荐） #

泛型外键默认会触发N+1查询，获取文档列表时在ORM查询中添加预加载即可解决：

# 示例视图中的查询代码
documents = Document.objects.all().prefetch_related('content_object')

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