如何在Django中使用外键字段排序且避免查询返回重复行

Group和GroupUser为一对多关联关系，直接跨该关联做查询会触发LEFT JOIN，1条Group记录会匹配多条GroupUser记录，因此会返回重复的Group对象。
直接调用distinct()失效的原因：排序字段包含关联表GroupUser的is_favorite，不同关联记录的is_favorite值存在差异，数据库判定为不同记录无法去重。
另外原查询的关联路径存在错误：GroupUser中group字段设置的related_name为groupuser_group_id，从Group反向关联GroupUser时应使用该名称，而非groupuser。

方案1：基于Exists子查询注解排序（推荐，无重复问题） #

适合需要针对指定用户的收藏状态排序的场景，Django 3.0及以上版本支持，性能优异，不会产生重复记录：

from django.db.models import Exists, OuterRef

# 构造子查询：判断目标用户是否将当前Group加入收藏
target_user = request.user  # 替换为实际业务中的目标用户
favorite_subquery = GroupUser.objects.filter(
    group=OuterRef('pk'),
    user=target_user,
    is_favorite=True
)

# 为Group注解收藏状态后排序
group_queryset = Group.objects.filter(is_active=True).annotate(
    is_favorite_for_user = Exists(favorite_subquery)
).order_by('-is_favorite_for_user')  # 减号代表降序，收藏的Group排在最前

方案2：基于聚合统计排序 #

适合需要按Group的总收藏人数排序的场景：

from django.db.models import Count, Q

group_queryset = Group.objects.filter(is_active=True).annotate(
    favorite_total = Count(
        'groupuser_group_id',
        filter=Q(groupuser_group_id__is_favorite=True)
    )
).order_by('-favorite_total')

方案3：指定distinct字段（仅PostgreSQL支持） #

如果必须使用JOIN的查询方式，且使用PostgreSQL作为数据库，可以指定distinct的主键字段实现去重：

group_queryset = Group.objects.filter(
    is_active=True,
    groupuser_group_id__user=target_user  # 先过滤对应用户的关联记录，避免多余匹配
).distinct('id').order_by('id', '-groupuser_group_id__is_favorite')

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