Django中如何从ManyToMany字段获取单个模型用于Serializer

你原代码存在两个核心问题：

1. Membership模型关联的是Person而非User，过滤条件应该用person字段而非user_id；
2. 直接用Subquery(Membership.objects.filter(...))无法返回可直接引用的单个对象，Django的Subquery需要配合字段指定或用Prefetch预取关联对象。

下面提供两种可行实现方案：

方案一：用Prefetch预取当前用户的Membership #

适合需要完整访问中间表字段的场景，能获取完整的Membership对象。

视图查询代码 #

from django.db.models import Prefetch

# 假设Person与Django默认User是一对一关联（Person含user字段），若Person直接作为用户模型，替换成current_person = request.user即可
current_person = request.user.person

groups = Group.objects.prefetch_related(
    Prefetch(
        # Group到Membership的反向关联，默认规则为「模型名小写_set」
        'membership_set',
        # 过滤当前用户对应的Membership
        queryset=Membership.objects.filter(person=current_person),
        # 自定义属性名，供Serializer调用
        to_attr='request_user_membership'
    )
).all()

Serializer代码 #

由于to_attr返回的是查询集（即使仅一条数据），用SerializerMethodField处理更稳妥：

class GroupSerializer(serializers.ModelSerializer):
    user_name = serializers.SerializerMethodField()

    def get_user_name(self, obj):
        membership = obj.request_user_membership.first()
        return membership.person.name if membership else None

    class Meta:
        model = Group
        fields = ['name', 'user_name']

方案二：用annotate直接注入目标字段 #

仅需获取中间表关联的单个字段（如用户名）时，可直接通过annotate+Subquery将字段注入Group对象。

视图查询代码 #

from django.db.models import Subquery, OuterRef, CharField

current_person = request.user.person

groups = Group.objects.annotate(
    user_name=Subquery(
        Membership.objects.filter(
            group_id=OuterRef('id'),
            person=current_person
        ).values('person__name')[:1],  # 限制返回单个值
        output_field=CharField()
    )
).all()

Serializer代码 #

直接使用annotate生成的字段即可：

class GroupSerializer(serializers.ModelSerializer):
    class Meta:
        model = Group
        fields = ['name', 'user_name']

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