如何在Django中使用.annotate创建ForeignKey字段实现关联查询？

方法一：使用Django原生Prefetch（推荐） #

Prefetch是Django自带的预取关联对象工具，可指定过滤条件，一次性完成查询，返回真实的模型实例，完全匹配你的需求。

假设模型定义如下：

class Invoice(models.Model):
    # 你的其他业务字段
    pass

class InvoicePayment(models.Model):
    invoice = models.ForeignKey(Invoice, on_delete=models.CASCADE, related_name='payments')
    provided_amount = models.DecimalField(max_digits=10, decimal_places=2)
    date = models.DateField()

查询实现代码：

from django.db.models import Prefetch
from django.utils import timezone

today = timezone.now().date()
# 定义带日期过滤条件的预取规则
today_payment_prefetch = Prefetch(
    'payments',  # 对应InvoicePayment的related_name
    queryset=InvoicePayment.objects.filter(date=today),
    to_attr='today_payment'  # 自定义属性名，存储符合条件的支付记录
)

# 执行查询，预取符合条件的支付对象
queryset = Invoice.objects.prefetch_related(today_payment_prefetch)

# 访问关联对象
invoice = queryset.first()
if invoice.today_payment:
    # 一对多关系下today_payment是列表，取第一个元素（假设单日单发票最多一条支付记录）
    print(invoice.today_payment[0].provided_amount)

该方案优势：

• 原生支持，无需额外依赖库
• 返回InvoicePayment模型实例，可直接调用模型方法与属性
• 仅生成两次SQL查询（一次查发票、一次查符合条件的支付记录），避免N+1性能问题

方法二：用Subquery结合JSONObject（单SQL查询，PostgreSQL专属） #

如果需要单条SQL完成查询，且接受字典形式的对象结构，可结合PostgreSQL的JSONObject函数实现：

from django.db.models import Subquery, OuterRef
from django.contrib.postgres.functions import JSONObject
from django.utils import timezone

today = timezone.now().date()
queryset = Invoice.objects.annotate(
    invoice_payment=Subquery(
        InvoicePayment.objects.filter(
            invoice_id=OuterRef('id'),
            date=today
        ).annotate(
            # 将支付字段打包为JSON对象
            payment_obj=JSONObject(
                id='id',
                provided_amount='provided_amount',
                date='date'
            )
        ).values('payment_obj')[:1]  # 仅取第一条符合条件的记录
    )
)

# 访问字段
invoice = queryset.first()
if invoice.invoice_payment:
    print(invoice.invoice_payment['provided_amount'])

注意：此方案仅适用于PostgreSQL数据库，返回结果为字典而非模型实例，适合必须单SQL查询的场景。

关于SQL VIEW的替代说明 #

你提到的SQL VIEW绑定managed=False模型的方式虽可行，但需手动维护VIEW的SQL语句，字段或条件变更时需同步更新VIEW，灵活性与维护成本远不如上述原生方案，不推荐使用。

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