Django ORM子查询报错：含外部查询引用仅可用于子查询问题排查

核心错误原因 #

• 你在Subquery内部调用了aggregate()方法，这是触发报错的关键：
  • aggregate()会直接触发数据库查询，而你的subquery中包含OuterRef("store_id")——这种引用外部查询的QuerySet不能直接执行，只能作为子查询嵌套使用，这就是报错的直接原因。
  • 其次，aggregate()返回的是字典类型（例如{'avg_sales_per_month__avg': 数值}），但Subquery要求传入的是能返回单行单列结果的QuerySet，类型完全不匹配。

正确实现方式 #

你的需求是：先计算每个门店每月的平均销量，再对这些月平均值求总平均，最后按store_id分组返回结果。可以通过嵌套子查询来实现：

写法一：分层嵌套子查询 #

先定义计算每月平均销量的内层子查询，再基于它计算总平均：

# 内层子查询：计算每个门店每月的平均销量
monthly_avg_subquery = StoreStatistics.objects.filter(
    store=OuterRef("store_id"),
    products__in=products,
    created_date__gte='2023-01-01',
).annotate(
    month=TruncMonth("created_date")
).values("store", "month").annotate(
    avg_sales_per_month=Avg("quantity")
).values("avg_sales_per_month")  # 仅保留用于计算总平均的字段

# 外层子查询：基于月平均结果计算总平均
overall_avg_subquery = StoreStatistics.objects.filter(
    store=OuterRef("store_id")
).annotate(
    avg_sales=Avg(Subquery(monthly_avg_subquery))
).values("avg_sales")

# 主查询：关联门店并返回结果
queryset = Company.objects.filter(
    company_id=company_id
).annotate(
    avg_sales=Subquery(overall_avg_subquery)
).values("store_id", "avg_sales")

写法二：单次嵌套子查询（更简洁） #

通过连续的values和annotate操作，在一个子查询内完成两次聚合：

queryset = Company.objects.filter(company_id=company_id).annotate(
    avg_sales=Subquery(
        StoreStatistics.objects.filter(
            store=OuterRef("store_id"),
            products__in=products,
            created_date__gte='2023-01-01'
        )
        # 第一步：按门店+月份分组，计算每月平均销量
        .annotate(month=TruncMonth("created_date"))
        .values("store", "month")
        .annotate(monthly_avg=Avg("quantity"))
        # 第二步：按门店分组，计算月平均的总平均
        .values("store")
        .annotate(overall_avg=Avg("monthly_avg"))
        .values("overall_avg")  # 返回单行单列结果供Subquery使用
    )
).values("store_id", "avg_sales")

关键逻辑说明 #

两次annotate+values的组合是核心：

1. 第一次values("store", "month")+annotate(monthly_avg=Avg("quantity"))：按门店和月份分组，得到每个门店每月的平均销量。
2. 第二次values("store")+annotate(overall_avg=Avg("monthly_avg"))：按门店分组，对第一步得到的月平均值求总平均。
3. 最后用values("overall_avg")确保子查询返回单行单列，符合Subquery的要求。

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