如何在Django中为Parent模型注解对应的男女子级信息

我有一个定义了父子关系的简单数据库，包含两个模型。其中Child模型有两种性别选项："Male"和"Female"，模型代码如下：

class Parent(models.Model):
    id = models.UUIDField(primary_key=True, editable=False, unique=True, )
    name =  models.CharField(max_length=64)


MALE = "MALE"
FEMALE = "FEMALE"

class Child(models.Model):
    id = models.UUIDField(primary_key=True, editable=False, unique=True, )
    name =  models.CharField(max_length=64)

    parent = models.ForeignKey(
        Parent,
        null=True,
        on_delete=models.SET_NULL)

    GENDER = [
        (MALE, 'Male'),
        (FEMALE, 'Female'),
    ]
    status = models.CharField(
        max_length=8,
        choices=GENDER
    )

注：代码中Child模型的性别字段定义为status，但后续过滤代码用了gender，属于笔误，解决方案将统一按gender字段处理，若实际为status可自行替换。

本次场景中，每个Parent最多拥有0个或1个男性子级、0个或1个女性子级（未在数据库模型中强制约束）。我希望实现一个注解查询，返回所有Parent对象，并为其注解对应的男性子级和女性子级。目前我能获取所有Parent、所有男性和女性子级，但不知道如何将正确的子级与对应Parent关联。我的代码进展如下：

annotated_parent_set = Parent.objects.get_queryset()
brothers = Child.objects.filter(gender=MALE)
sisters = Child.objects.filter(gender=FEMALE)
annotated_parent_set = annotated_parent_set.annotate(
    brother=F(???))
)
annotated_parent_set = annotated_parent_set.annotate(
     sister=F(???))
)

请问如何完成该注解需求？

要实现这个需求，需使用Subquery和OuterRef来关联父级与对应子级，利用子查询精准匹配每个父级的特定性别子级。

完整实现代码 #

from django.db.models import Subquery, OuterRef

# 定义男性子级的子查询：匹配当前父级的男性子级，取第一个结果（最多一个）
male_child_subquery = Child.objects.filter(
    parent_id=OuterRef('id'),
    gender=MALE
).values('name')[:1]

# 定义女性子级的子查询
female_child_subquery = Child.objects.filter(
    parent_id=OuterRef('id'),
    gender=FEMALE
).values('name')[:1]

# 为Parent查询集添加注解
annotated_parent_set = Parent.objects.annotate(
    brother=Subquery(male_child_subquery),
    sister=Subquery(female_child_subquery)
)

关键说明 #

• 若Child模型中性别字段实际是status，只需将过滤条件中的gender替换为status即可。
• values('name')指定注解的是子级的名称字段，若需要其他字段（如id），可修改括号内的字段名；若需注解完整子级对象，Django 3.2+支持直接去掉values()，但更推荐注解具体字段以提升性能。
• [:1]确保只返回一个结果，符合场景中每个父级最多一个对应性别子级的约束。

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