Django3.0 Subquery Sum无结果返回None而非0问题求解

问题根因 #

子查询内使用Sum(..., default=0)、聚合层包裹Coalesce无法解决无匹配行返回None的问题，核心原因是：当子查询筛选后无任何符合条件的记录时，数据库不会执行聚合计算逻辑，会直接返回NULL值。聚合函数的default参数、聚合层的Coalesce逻辑仅在子查询匹配到至少1条记录时才会执行，无法兜底空结果场景。
之前使用~Exists('tapx')抛出'str' object has no attribute 'order_by'错误，是因为Exists构造方法的入参必须为QuerySet实例，传入字段名字符串时，Django内部会尝试调用入参的order_by方法处理查询语句，字符串类型无该方法自然触发报错。

可行方案 #

方案1：外层包裹Coalesce（推荐，代码最简洁） #

Coalesce不要写在Subquery内部的聚合逻辑上，直接将整个Subquery作为Coalesce的第一个参数，设置0为兜底值即可，代码如下：

from django.db.models import Subquery, Sum, OuterRef, F, Coalesce, Value

annotate(
    tapx=Coalesce(
        Subquery(
            InvTrx.objects.filter(
                job=OuterRef('job'),
                consumed__isnull=False,
                inventory__inv_type='APX'
            )
            .values('job__job')
            .annotate(tot_cons=Sum('consumed'))
            .values('tot_cons')
        ),
        Value(0)
    )
).annotate(
    fg_total=F('fg') + F('tapx')
)

该写法会统一兜底所有子查询返回NULL的场景，不管是无匹配行导致的NULL，还是聚合计算本身返回的NULL，最终都会被转为0，后续F表达式做算术计算时不会出现NULL传染导致结果为None的问题。子查询内部的Sum不需要再加default参数，外层兜底已经覆盖所有场景，加了属于冗余代码。

方案2：复用子查询加Exists判断（适合多分支逻辑场景） #

如果业务逻辑中除了计算总和，还需要判断是否存在匹配的记录，可以将子查询筛选逻辑抽成复用对象，传入Exists做判断，避免重复写筛选条件，代码如下：

from django.db.models import Subquery, Sum, OuterRef, F, Case, When, Exists, Value

# 抽离子查询公共筛选逻辑
apx_trx_filter = InvTrx.objects.filter(
    job=OuterRef('job'),
    consumed__isnull=False,
    inventory__inv_type='APX'
)

annotate(
    has_apx_record=Exists(apx_trx_filter),
    tapx=Subquery(
        apx_trx_filter
        .values('job__job')
        .annotate(tot_cons=Sum('consumed'))
        .values('tot_cons')
    )
).annotate(
    fg_total=F('fg') + Case(
        When(has_apx_record=True, then=F('tapx')),
        default=Value(0)
    )
)

该方案代码冗余度高于方案1，仅在需要额外使用存在性判断字段时选择即可。

补充说明 #

• SQL语法规则中，NULL参与任何算术运算的结果都为NULL，只要提前对可能为NULL的字段做兜底转换，就不会出现计算结果异常的问题
• 上述两个方案完全适配Django 3.0版本，不需要升级框架即可使用
• 不要尝试在Python层面通过or 0处理QuerySet注解结果，注解逻辑是翻译成SQL在数据库层执行的，Python层面的语法不会生效

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