Profile模型get_tag_posts方法QuerySet去重失效问题排查

核心原因 #

你的distinct()没起作用，是因为当查询中使用关联模型字段排序时，Django会把排序字段加入SQL的SELECT列表，导致DISTINCT无法按Tag本身去重。

比如你用order_by="-question__date"时，生成的SQL会同时选择Tag的字段和Question的date字段。同一个Tag关联的不同Question有不同的date，SQL会把这些视为不同的行返回，所以distinct()过滤不掉重复的Tag实例。

修复代码 #

直接重构查询逻辑，先确保Tag去重，再通过annotate统计使用次数，最后处理排序（避免用关联字段直接排序）：

class Profile(Model):
    user = OneToOneField(settings.AUTH_USER_MODEL, on_delete=CASCADE)

    def get_tag_posts(self, order_by=None):
        # 第一步：获取该用户所有关联的Tag，确保完全去重
        base_tags = Tag.objects.filter(question__profile=self).distinct()

        # 第二步：为每个Tag统计该用户的使用次数
        tagged_counts = base_tags.annotate(
            times_posted=Count(
                'question', 
                filter=Q(question__profile=self),
                distinct=True  # 确保每个Question只算一次，避免多标签重复计数
            )
        )

        # 第三步：处理排序逻辑，避免直接用关联字段排序
        if not order_by:
            # 默认按使用次数倒序；如果要按最新问题日期，用子查询获取每个Tag的最新日期
            tagged_counts = tagged_counts.order_by('-times_posted')
            # 若需按最新问题日期排序，替换上面一行：
            # latest_q_date = Subquery(
            #     self.questions.filter(tags=OuterRef('pk')).order_by('-date').values('date')[:1]
            # )
            # tagged_counts = tagged_counts.annotate(latest_date=latest_q_date).order_by('-latest_date')
        elif order_by == "name":
            tagged_counts = tagged_counts.order_by('name')
        else:
            # 按score排序时，用子查询获取每个Tag关联问题的最高score
            max_score = Subquery(
                self.questions.filter(tags=OuterRef('pk')).order_by('-score').values('score')[:1]
            )
            tagged_counts = tagged_counts.annotate(max_score=max_score).order_by('-max_score')

        return {
            'records': tagged_counts,
            'title': f"{tagged_counts.count()} Tags"
        }

关键优化点 #

• 去掉冗余Subquery：直接用Count('question', filter=...)就能准确统计用户使用Tag的次数，比子查询更高效简洁。
• 排序逻辑调整：避免直接用question__date或question__score排序，改用子查询为每个Tag计算单一排序值（如最新日期、最高score），不会破坏去重结果。
• Count参数优化：添加distinct=True确保同一个Question即使关联多个Tag，也只会被计数一次（适配多数业务场景）。

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