Django Admin搜索含多对多字段时返回重复结果的解决求助

我在使用Django Admin的搜索功能时，遇到了返回重复对象的问题。涉及两个模型：Organisation（组织）和OrgAlias（组织别名），二者是多对多关联关系——每个Organisation可关联多个别名，每个别名也可关联多个Organisation。

模型代码 #

class OrgAlias(models.Model):
    name = models.CharField(max_length=255, unique=True)
    def __str__(self):
            return self.name

class Organisation(models.Model):
    id = models.UUIDField(
        primary_key=True,
        default=uuid.uuid4,
        editable=False)
    aliases = models.ManyToManyField(OrgAlias)
    # 其他字段省略

Admin配置代码 #

class OrganisationAdmin(admin.ModelAdmin):
    search_fields = ['aliases__name']
    # 其他配置省略

尝试过的去重方法 #

我尝试过重写ModelAdmin的get_search_results方法来手动去重，代码如下：

def get_search_results(self, request, queryset, search_term):
    queryset, use_distinct = super().get_search_results(request, queryset, search_term) 
    queryset = queryset.distinct()
    return queryset, use_distinct

但问题依旧：如果一个Organisation关联了3个别名，搜索结果中该组织会重复出现3次。类似的查询在Django Shell中运行正常，仅在Admin中出现此问题。

有效解决办法 #

核心问题是手动调用queryset.distinct()可能会被Django Admin后续的分页、排序等操作覆盖。正确的做法是让Admin自动处理去重，只需要修改get_search_results方法的返回值，将use_distinct设为True：

def get_search_results(self, request, queryset, search_term):
    queryset, use_distinct = super().get_search_results(request, queryset, search_term)
    # 标记需要去重，Django Admin会自动应用distinct()
    return queryset, True

原理是：Django Admin内部会根据use_distinct这个返回标记，在整个查询处理流程中自动为查询集添加去重逻辑，避免后续操作破坏去重效果。

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