Django：如何获取关联模型管理器注解字段？Subquery性能不佳求优化

问题根源 #

Django执行关联查询时，默认会使用关联模型的_default_manager（默认管理器）生成查询集。如果Project模型的自定义管理器get_queryset中添加了display注解，但该管理器不是默认管理器，关联查询时不会自动包含这个注解字段，就会出现project__display不存在的错误。而直接在过滤条件里用Subquery会触发N+1查询，导致性能低下。

可行解决方案 #

方案1：将自定义Manager设为Project模型的默认管理器

这是性能最优的方案，能让Django在关联查询时自动使用带display注解的查询集。

1. 配置自定义管理器为默认：

from django.db import models

class ProjectManager(models.Manager):
    def get_queryset(self):
        # 示例：根据实际需求写你的注解逻辑
        return super().get_queryset().annotate(
            display=models.Concat(models.F('name'), models.Value(' - '), models.F('code'))
        )

class Project(models.Model):
    name = models.CharField(max_length=100)
    code = models.CharField(max_length=20)
    # 将自定义管理器设为默认
    objects = ProjectManager()
    # 若有多个管理器，显式指定默认管理器名称（可选，Django默认识别第一个定义的管理器）
    default_manager_name = 'objects'

2. 直接使用关联过滤即可生效：

invoices = Invoice.objects.filter(project__display__iregex=r'your_pattern')

注意：如果有场景不需要display注解，可以额外定义基础管理器：

class BasicProjectManager(models.Manager):
    pass

class Project(models.Model):
    # ... 现有字段
    objects = ProjectManager()
    basic_objects = BasicProjectManager()  # 无注解的原始查询集管理器

需要纯原始数据时，用Project.basic_objects.all()即可。

方案2：在Invoice模型的自定义Manager中预注解关联字段

如果不能修改Project的默认管理器，可以在Invoice的管理器中预先把display字段注解到查询集，避免重复编写子查询：

from django.db import models
from django.db.models import OuterRef, Subquery

class InvoiceManager(models.Manager):
    def get_queryset(self):
        # 复用Project自定义管理器的查询集
        project_display_qs = Project.objects.filter(id=OuterRef('project_id')).values('display')[:1]
        return super().get_queryset().annotate(
            project_display=Subquery(project_display_qs)
        )

class Invoice(models.Model):
    project = models.ForeignKey(Project, on_delete=models.CASCADE)
    amount = models.DecimalField(max_digits=10, decimal_places=2)
    objects = InvoiceManager()

使用时直接过滤注解后的字段：

invoices = Invoice.objects.filter(project_display__iregex=r'your_pattern')

这种方式会把子查询整合进主SQL语句，仅执行一次查询，比在过滤条件里单独写Subquery性能好很多。

原Subquery性能低的原因 #

原写法在filter里用Subquery时，Django会为每个Invoice对象单独执行一次子查询（N+1查询），产生大量重复SQL请求。而把注解放在get_queryset中时，Django会将子查询合并到主查询里，仅执行一次，性能大幅提升。

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