Django条件表达式非空检查及无外键关联字段注解实现问题

问题原因 #

你编写的QuerySet之所以抛出DoesNotExist异常，核心原因是DefaultDescription.objects.get是Python层面执行的查询，在你构造QuerySet对象时就会立即运行，而不是作为SQL逻辑的一部分等到条件判断时再执行，因此不管When条件是否成立，get方法都会先执行，找不到匹配记录就直接抛出异常。

解决方案 #

可以使用Django的Subquery+OuterRef实现关联查询，完全不需要修改模型层的关联关系，也不会触发N+1查询：

第一步：实现自定义QuerySet #

from django.db.models import Subquery, OuterRef, Value, CharField
from django.db.models.functions import Coalesce

class DescriptionAnnotationQS(models.QuerySet):
    def annotate_descriptions(self):
        # 构造子查询，匹配两个关联字段，取对应description
        desc_subquery = DefaultDescription.objects.filter(
            first_attr=OuterRef("first_attr"),
            second_attr=OuterRef("second_attr")
        ).values("description")[:1]

        # 注解desc字段，无匹配时默认返回空字符串
        return self.annotate(
            desc=Coalesce(
                Subquery(desc_subquery, output_field=CharField()),
                Value("")
            )
        )

第二步：绑定管理器并兼容原有逻辑 #

修改SomeEntity模型，绑定自定义QuerySet，同时修改property优先读取注解字段：

class SomeEntity(models.Model):
    first_attr = models.IntegerField()
    second_attr = models.CharField(max_length=20)
    # 其余非核心属性省略...

    # 绑定自定义QuerySet为管理器
    objects = DescriptionAnnotationQS.as_manager()

    @property
    def description(self):
        # 优先读取注解字段，避免N+1
        if hasattr(self, "desc"):
            return self.desc
        # 兼容原有逻辑，未注解时走旧查询
        try:
            return DefaultDescription.objects.get(first_attr=self.first_attr, second_attr=self.second_attr).description
        except DefaultDescription.DoesNotExist:
            return ""

使用方式 #

查询时调用annotate_descriptions方法即可：

# 单次查询即可拿到所有实例的description，无N+1问题
entities = SomeEntity.objects.annotate_descriptions().all()
# 直接访问description属性，不会触发额外查询
for entity in entities:
    print(entity.description)

该方案完全符合遗留系统不能建立模型关联的限制，不需要修改原有业务逻辑，旧代码可以无缝兼容，仅在需要批量查询时调用注解方法即可获得性能提升。

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