如何用Django ORM的Case/When关联模型实现动态状态名？

模型定义 #

我有两个Django模型：

Labels模型 #

用于映射类型代码与标签名称，比如优惠券状态代码2对应"expired"：

class Labels(models.Model):
    label_id= models.AutoField(primary_key=True)
    label_type = models.CharField(null=False, max_length=50)
    label_code= models.IntegerField()
    label_name = models.CharField(max_length=50)   

Coupons模型 #

存储优惠券核心数据：

class Coupons(models.Model):
    coupon_id = models.AutoField(primary_key=True, null=False, unique=True)
    coupon_name = models.CharField(max_length=200, null=False)
    coupon_desc= models.CharField(max_length=200, null=False)
    valid_date = models.DateField(null=False)
    status = models.IntegerField(null=False)

需求 #

需要通过Django ORM为Coupons查询集生成动态字段coupon_status_name，规则如下：

• 当优惠券status=0且valid_date <= 今日时，取Labels中label_code=2对应的label_name（即"expired"）；
• 其他情况，用Coupons的status字段匹配Labels的label_code，取对应的label_name。

已通过extra方法实现，但该方法已被弃用且无法对生成的字段使用filter，因此需要改用Case/When实现。

问题场景 #

之前尝试直接在Case的default中用OuterRef关联字段时，触发错误：This queryset contains a reference to an outer query and may only be used in a subquery.，因为直接调用first()会在Python层面执行查询，无法正确关联外部查询的字段。

解决方案 #

使用Subquery将标签查询嵌入到主查询中，让数据库层面完成关联匹配：

from django.db.models import Case, When, Subquery, OuterRef, CharField
from datetime import date

# 预先筛选出优惠券状态类型的标签查询集
coupon_status_labels = Labels.objects.filter(label_type='coupon_status')

# 子查询：获取过期状态对应的标签名称
expired_label_subq = coupon_status_labels.filter(label_code=2).values('label_name')[:1]

# 子查询：根据当前优惠券的status字段匹配对应的标签名称
status_match_subq = coupon_status_labels.filter(
    label_code=OuterRef('status')
).values('label_name')[:1]

# 生成带动态字段的查询集
coupons_with_status_name = Coupons.objects.annotate(
    coupon_status_name=Case(
        When(
            status=0, valid_date__lte=date.today(),
            then=Subquery(expired_label_subq)
        ),
        default=Subquery(status_match_subq),
        output_field=CharField()
    )
).all()

说明 #

1. 使用Subquery将标签查询转为数据库层面的子查询，避免在Python端提前执行查询，确保OuterRef能正确关联Coupons表的status字段；
2. values('label_name')[:1]确保子查询只返回单个值，符合Case/When的then和default要求；
3. 生成的coupon_status_name字段可以正常用于后续的filter、order_by等ORM操作，解决了extra方法的局限性。

内容的提问来源于stack exchange，提问作者Fath-Likki