Django ORM annotate聚合Sum返回None如何设置默认值为0

出现该问题的核心原因是：当关联路径invoice__transaction_invoice下没有匹配记录时，Sum聚合的结果在数据库层面会返回NULL，映射到Python中就是None。如果要在聚合阶段直接把空值替换为0，使用Django内置的Coalesce函数即可实现，这也是最高效的处理方案。

代码修改示例 #

首先导入需要的ORM函数：

from django.db.models import Count, Sum, Value
from django.db.models.functions import Coalesce

修改你的annotate逻辑，将Sum包裹在Coalesce中：

order_list_cases = order_list.values('user_id').annotate(
    dcount=Count('user_id'),
    customer_paid_sum=Coalesce(
        Sum('invoice__transaction_invoice__transaction_amount'),
        Value(0)
    )
)

注意事项 #

• 必须用Value(0)包裹常量0，不能直接写0，否则Django会将0识别为字段名，抛出字段不存在的报错。
• 如果你的Django版本低于3.2，也可以用Case+When组合实现相同效果：

from django.db.models import Count, Sum, Case, When, IntegerField

order_list_cases = order_list.values('user_id').annotate(
    dcount=Count('user_id'),
    customer_paid_sum=Case(
        When(invoice__transaction_invoice__transaction_amount__isnull=True, then=Value(0)),
        default=Sum('invoice__transaction_invoice__transaction_amount'),
        output_field=IntegerField()
    )
)

• 该方案是在数据库查询阶段直接处理空值，比查询后再用Python代码判断替换性能更好，也支持后续直接对customer_paid_sum字段做排序、过滤等操作。

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