Django中如何通过Annotation为Subject关联指定Object图片？

问题场景 #

现有Django模型关系：

• Object 关联 Hromady
• ObjectImages 通过外键关联 Object，包含image字段和select布尔字段（默认False）
• Subject 通过外键关联 Object

需要通过annotate为每个Subject关联其对应Object中select=1的单张图片（无符合条件图片则为None），此前使用Count或直接引用F字段的写法无法满足需求。

解决方案 #

使用Subquery结合OuterRef实现精准的单条记录关联查询：

首先导入必要的模块：

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

构造查询语句：

# 子查询：获取当前Subject关联Object下select=True的ObjectImages的image字段（取第一条）
selected_image_subquery = ObjectImages.objects.filter(
    object=OuterRef('object'),
    select=True
).values('image')[:1]

# 查询Subject并注解image字段
subject_list = Subject.objects.filter(
    object__hromada_id=hromada.id,
    state=3
).annotate(
    image=Subquery(selected_image_subquery, output_field=models.ImageField())
)

说明 #

• 子查询通过OuterRef('object')关联外层Subject的object字段，确保每个Subject只查询自身关联Object的图片
• [:1]限制只取第一条符合条件的记录，保证单张图片的需求
• 若没有符合select=True的图片，注解的image字段会自动为None
• 若需要指定图片的排序规则（比如按创建时间），可在子查询中添加.order_by('-created_at')（替换为实际字段）

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