Django ORM子查询用作表达式返回多行的跨环境异常问题

异常原因 #

• 核心是Django ORM的默认排序规则干扰了分组逻辑：你未显式清除排序的情况下，Sale模型Meta类中定义的默认排序字段price会被自动加入GROUP BY和ORDER BY子句，导致你预期按object_id单字段分组聚合的逻辑，实际执行的是按object_id + price联合分组。
• 不同环境表现差异由数据特性导致：本地环境同一object_id对应的所有Sale记录price值完全一致，联合分组后仍仅生成1组结果，子查询可正常返回单值；开发环境同一object_id对应的Sale记录price值存在差异，联合分组后生成多组结果，子查询返回多行触发报错。

解决方案 #

最稳妥的修复方式是在子查询中显式清空默认排序，消除多余分组字段：

Sale.objects.filter(object_id=OuterRef("id"), is_canceled=False)
.values("object")
.order_by()  # 新增该行清除模型默认排序
.annotate(total_amount=Coalesce(Sum("amount"), 0))
.values("total_amount") 

修改后生成的SQL会移除GROUP BY和ORDER BY中的price字段，仅按object_id单字段分组求和，无论同object_id下的price是否存在差异，都只会返回单条聚合结果，不会再触发多行返回的异常。

如果业务逻辑需要保留特定排序，也可以在子查询末尾使用[:1]限制返回行数，但该方式仅做结果截断，没有从根源解决分组逻辑错误，更推荐使用清空排序的方案。

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