Django GROUP BY子句中子查询引发SQL错误的解决及疑问

1. 错误修复方案 #

错误根源是合并两个结构不一致的QuerySet（一个经过annotate分组，一个未分组）时，Django ORM错误地将子查询加入到GROUP BY子句中，而该子查询返回多行结果，触发SQL错误。

修复后的QuerySet写法 #

user = self.request.user
# 先获取用户关联的所有项目ID列表，避免子查询被带入GROUP BY
project_ids = EmployeeProject.objects.filter(
    employee=user.employee
).values_list('project_id', flat=True)

# 用Q表达式合并两个条件，避免拆分后再合并QuerySet
qs = Task.objects.annotate(
    total_estimated_hours=Sum('roles__estimated_hours')
).filter(
    # 合并两个过滤条件：用户参与项目的有效任务 OR 用户创建的任务
    Q(project__in=project_ids, total_estimated_hours__isnull=False) | Q(author=user)
).values('id').distinct()

return qs

修复逻辑说明 #

• 提前提取project_ids为扁平列表，替代原代码中嵌套的子查询，避免Django将子查询误加入GROUP BY。
• 使用Q表达式直接合并两个过滤条件，不需要拆分后再做OR操作，保证整个查询的结构一致性，GROUP BY只会包含Task.id（annotate自动生成的分组字段）。

2. GROUP BY子句出现子查询的原因 #

原代码中，你先对Task做了annotate(Sum('roles__estimated_hours'))，这会触发SQL的GROUP BY tasks_task.id（因为要按任务分组计算总工时）。随后你将这个分组后的QuerySet和另一个未分组的QuerySet（qs.filter(author=user)）做OR合并。

Django ORM在合并两个结构不同的QuerySet时，会尝试统一查询的分组、筛选等逻辑。在处理project__in=host_roles.values('project_id')这个条件时，ORM错误地将该子查询作为一个"字段"加入到GROUP BY子句中，而这个子查询（SELECT U0.project_id FROM tasks_employeeproject U0 WHERE U0.employee_id = 1）会返回多行结果，违反了SQL中"子查询作为表达式必须返回单行"的规则，因此报错。

简单来说：ORM对不同结构QuerySet的合并逻辑处理不当，将原本只应出现在WHERE/HAVING中的子查询错误地放到了GROUP BY里。

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