Django中如何用FilteredRelation实现外键注释、过滤及字段访问

首先明确：FilteredRelation无法直接实现你需要的在循环中访问对应类型披萨实例的需求。它的设计初衷是为查询集创建一个过滤后的关联关系，用于后续的过滤、统计（比如计数）等操作，不能直接作为模型实例的属性来获取关联对象。

针对你的场景（每个餐厅对应3种类型的披萨，需在查询餐厅时一次性获取各类型的披萨实例或None），推荐使用Subquery + Prefetch的组合方案，具体实现步骤如下：

1. 假设你的模型结构 #

from django.db import models

class Restaurant(models.Model):
    name = models.CharField(max_length=100)

class Pizza(models.Model):
    TYPE_CHOICES = [(1, 'Type 1'), (2, 'Type 2'), (3, 'Type 3')]
    restaurant = models.ForeignKey(Restaurant, on_delete=models.CASCADE, related_name='pizzas')
    type = models.IntegerField(choices=TYPE_CHOICES)
    name = models.CharField(max_length=100)

2. 构造查询集并注释字段 #

通过Subquery获取每个餐厅对应类型披萨的ID，再用Prefetch预加载所有相关披萨，避免N+1查询：

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

# 定义子查询：获取对应类型的第一个披萨ID
pizza1_subquery = Pizza.objects.filter(
    restaurant=OuterRef('pk'),
    type=1
).order_by('id').values('id')[:1]

pizza2_subquery = Pizza.objects.filter(
    restaurant=OuterRef('pk'),
    type=2
).order_by('id').values('id')[:1]

pizza3_subquery = Pizza.objects.filter(
    restaurant=OuterRef('pk'),
    type=3
).order_by('id').values('id')[:1]

# 查询餐厅并注释ID字段，同时预加载所有相关披萨
restaurants = Restaurant.objects.annotate(
    pizza1_id=Subquery(pizza1_subquery),
    pizza2_id=Subquery(pizza2_subquery),
    pizza3_id=Subquery(pizza3_subquery)
).prefetch_related(
    Prefetch(
        'pizzas',
        queryset=Pizza.objects.filter(type__in=[1,2,3]),
        to_attr='_all_pizzas'
    )
)

3. 添加属性方法方便访问 #

在Restaurant模型中添加@property方法，无需新增数据库字段，直接通过ID匹配预加载的披萨实例：

class Restaurant(models.Model):
    name = models.CharField(max_length=100)

    @property
    def pizza1(self):
        return next((p for p in self._all_pizzas if p.id == self.pizza1_id), None)

    @property
    def pizza2(self):
        return next((p for p in self._all_pizzas if p.id == self.pizza2_id), None)

    @property
    def pizza3(self):
        return next((p for p in self._all_pizzas if p.id == self.pizza3_id), None)

4. 循环中直接访问字段 #

现在你可以在循环中直接访问注释后的属性：

for restaurant in restaurants:
    print(f"餐厅：{restaurant.name}")
    print(f"Type1披萨：{restaurant.pizza1.name if restaurant.pizza1 else '无'}")
    print(f"Type2披萨：{restaurant.pizza2.name if restaurant.pizza2 else '无'}")
    print(f"Type3披萨：{restaurant.pizza3.name if restaurant.pizza3 else '无'}")

方案优势 #

• 仅需2次数据库查询（一次查询餐厅并获取披萨ID，一次预加载所有相关披萨），避免N+1问题
• 无需修改数据库结构，仅通过模型方法实现属性访问
• 逻辑清晰，便于维护和扩展

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