Django ORM中Count聚合表达式除法结果始终为0的问题

问题原因 #

这是整数除法取整导致的：Count聚合返回的是整数类型，当分子数值小于分母时，数据库的整数除法会直接舍去小数部分得到0，后续乘以100也无法改变结果。

解决办法 #

方法1：用Value(1.0)触发浮点除法 #

通过将其中一个运算数转换为浮点型，让数据库执行浮点除法而非整数除法：

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

drivers.annotate(
    completed_orders_percentage=(
        Count('orders', filter=Q(orders__rejected=False), distinct=True) 
        / 
        Count('orders', distinct=True) * Value(100.0)
    )
)

也可以先将分子转为浮点型：

drivers.annotate(
    completed_orders_percentage=(
        Count('orders', filter=Q(orders__rejected=False), distinct=True) * Value(1.0) 
        / 
        Count('orders', distinct=True) * 100
    )
)

方法2：正确使用ExpressionWrapper包裹运算 #

确保除法运算的结果被正确转为浮点型，再计算百分比：

from django.db.models import ExpressionWrapper, FloatField, Q, Count, F

# 分步计算更清晰
drivers.annotate(
    completed_ratio=ExpressionWrapper(
        Count('orders', filter=Q(orders__rejected=False), distinct=True) 
        / 
        Count('orders', distinct=True),
        output_field=FloatField()
    ),
    completed_orders_percentage=F('completed_ratio') * 100
)

或者直接在一个表达式内完成：

drivers.annotate(
    completed_orders_percentage=ExpressionWrapper(
        (Count('orders', filter=Q(orders__rejected=False), distinct=True) * 100.0) 
        / 
        Count('orders', distinct=True),
        output_field=FloatField()
    )
)

额外注意 #

如果分母（总订单数）可能为0，需要用Case/When处理避免报错：

from django.db.models import Case, When, Value, FloatField

drivers.annotate(
    total_orders=Count('orders', distinct=True),
    completed_orders_percentage=Case(
        When(total_orders=0, then=Value(0.0)),
        default=ExpressionWrapper(
            (Count('orders', filter=Q(orders__rejected=False), distinct=True) * 100.0) 
            / 
            F('total_orders'),
            output_field=FloatField()
        ),
        output_field=FloatField()
    )
)

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