在Django单查询中实现文件与子文件夹数量求和统计

在处理嵌套文件夹的统计需求时，要在查询集中直接统计每个文件夹内仅show_in_catalog=True的文件总数和子文件夹总数，最初用alias和annotate实现时出现数据错误，核心原因是多表关联查询时产生了重复计数，给两个Count聚合函数加上distinct=True即可解决。

核心实现代码（views.py中） #

假设你的模型定义如下：

• Folder模型包含自关联字段parent（用于表示父文件夹，反向关联名为children）
• File模型包含外键folder（关联所属文件夹）和布尔字段show_in_catalog

from django.db.models import Count, Q
from .models import Folder

def folder_statistics(request):
    # 直接在查询集层面完成统计
    folders_with_stats = Folder.objects.annotate(
        # 统计当前文件夹下的子文件夹总数
        subfolder_count=Count('children', distinct=True),
        # 统计当前文件夹下show_in_catalog=True的文件总数
        valid_file_count=Count(
            'file',
            filter=Q(file__show_in_catalog=True),
            distinct=True
        )
    )
    # 后续可直接使用folders_with_stats中的统计字段，无需额外处理
    ...

关键说明 #

• 多表关联查询时，若同时关联文件和子文件夹表，会生成笛卡尔积，导致计数重复；添加distinct=True能确保每个子文件夹和符合条件的文件仅被统计一次。
• 该方案直接在查询集层面完成统计，无需使用SerializerMethodField，性能更优且符合需求。

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