Django annotate做减法运算时减数为None返回None如何解决

核心原因 #

当没有符合过滤条件的PaidBills关联记录时，Sum聚合的返回值为NULL（对应Django中的None），SQL运算规则中数值 - NULL的结果始终为NULL，因此会出现new_bal为None的情况。

解决方案 #

Django 3.2原生支持Coalesce函数，该函数会返回传入参数中第一个非空值，我们可以用它把空的聚合结果替换为0，修改后的代码如下：

1. 首先导入依赖函数

from django.db.models import Sum, Q, F
from django.db.models.functions import Coalesce

2. 修改聚合注解逻辑

qs = Billing.objects.filter(
    bill_batch=prev_batch, balance__gt=0
).annotate(
    # 用Coalesce把空的Sum结果替换为0
    payment=Coalesce(
        Sum('paidbills__amount_paid', filter=Q(paidbills__pay_period=batch.period)),
        0
    )
).order_by(
    'reservation__tenant__name', 'reservation__apt_unit'
).only(
    'id', 'bill_batch', 'reservation'
)

qs = qs.annotate(new_bal=F('backlog') - F('payment'))

补充说明 #

如果后续升级到Django 4.0及以上版本，可以直接给Sum添加default=0参数实现相同效果，无需额外嵌套Coalesce：

payment=Sum('paidbills__amount_paid', filter=Q(paidbills__pay_period=batch.period), default=0)

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