Django基于部分字段聚合的条件注解：单查询获取文章前一日平均价格

原实现的核心缺陷 #

• 将前一日价格的过滤条件直接放在主Article查询的filter中，会触发内连接逻辑，直接把所有没有匹配到前一日Price记录的Article从结果集中剔除，根本无法走到后续的聚合注解环节。
• 代码存在两处冗余/错误：
  • select_related()仅适用于一对一、多对一的单条关联场景，Article和Price是一对多关联，该调用不会生效，属于冗余代码
  • 对带时分秒的DateTimeField做精确时间匹配，极易因时分秒不匹配漏算整日前一日的价格记录

实现思路 #

将“筛选前一日Price记录、计算对应平均价格”的逻辑下沉到注解的子查询中，保证主查询始终返回全量Article，仅在注解环节针对每篇文章匹配对应的价格聚合结果；无匹配记录时自动赋值为自定义默认值，全程通过单次SQL完成查询，避免N+1性能问题。

代码实现 #

from datetime import datetime, timedelta
from django.db.models import OuterRef, Subquery, Avg, Value
from django.db.models.functions import Coalesce

# 计算前自然日的完整时间区间，避免时分秒不匹配导致的漏算
current_day = datetime.now().date()
yesterday_start = datetime.combine(current_day - timedelta(days=1), datetime.min.time())
yesterday_end = datetime.combine(current_day, datetime.min.time())

# 构造针对单篇文章的前一日平均价格子查询
yesterday_avg_price = Price.objects.filter(
    article=OuterRef('pk'),
    date__gte=yesterday_start,
    date__lt=yesterday_end
).values('article').annotate(
    calc_avg=Avg('price')
).values('calc_avg')

# 全量查询文章，通过Coalesce自定义无价格记录时的默认值
articles = Article.objects.annotate(
    avg_price=Coalesce(
        Subquery(yesterday_avg_price),
        Value(None) # 可替换为Value(0)，将无记录的默认值设为0
    )
)

效果说明 #

• 结果集覆盖所有Article记录，不会因无对应前一日价格记录被过滤
• 存在前一日价格记录的文章，avg_price为对应时段所有价格的算术平均值
• 无对应前一日价格记录的文章，avg_price为Coalesce设置的自定义默认值
• 整个查询为单条SQL执行，无额外循环查询开销，满足生产场景性能要求

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