Django Admin中prefetch_related关联属性仍触发重复查询问题排查

你的问题核心在于预取数据的排序与first()方法的默认排序不匹配，导致Django无法直接使用预取的缓存数据，被迫发起重复查询。

具体原因 #

当你调用prefetch_related("phonenumber_set")时，Django会一次性拉取所有关联的PhoneNumber数据，但不会对这些数据做排序。而self.phonenumber_set.first()方法默认会按照PhoneNumber模型的默认排序规则（通常是主键id升序）去获取第一个对象。此时Django发现预取的数据集没有按该规则排序，就会重新发起单独的查询，最终导致N+1问题。

解决方案 #

方案1：预取时指定排序并自定义属性存储

通过Prefetch对象明确指定预取数据的排序规则，同时将预取结果存储到自定义属性中，避免调用first()触发新查询：

首先修改Admin的get_queryset方法：

from django.db.models import Prefetch

def get_queryset(self, request):
    return super().get_queryset(request).prefetch_related(
        Prefetch(
            'phonenumber_set',
            queryset=PhoneNumber.objects.order_by('id'),  # 与first()默认排序一致
            to_attr='sorted_phonenumbers'
        )
    )

然后修改Merchant模型的business_phone_number属性：

@property
def business_phone_number(self):
    numbers = getattr(self, 'sorted_phonenumbers', [])
    return numbers[0].phone_number if numbers else None

方案2：给PhoneNumber设置默认排序

直接在PhoneNumber模型中定义默认排序，让预取的数据自动遵循该顺序，这样first()就能直接使用预取缓存：

class PhoneNumber(models.Model):
    ...
    merchant = models.ForeignKey("merchant.Merchant", on_delete=models.SET_NULL, null=True, blank=True)
    ...

    class Meta:
        ordering = ['id']  # 设置与first()默认一致的排序规则

方案3：直接取预取集合的第一个元素（需确认顺序符合需求）

如果不需要严格遵循数据库的排序逻辑，只是需要任意一个关联手机号，可以直接从预取的集合中取第一个元素，跳过first()方法：

@property
def business_phone_number(self):
    numbers = self.phonenumber_set.all()
    return numbers[0].phone_number if numbers else None

额外检查点 #

确保你的get_queryset方法没有后续操作（如filter()、values()等）清空预取的缓存，这些操作会导致prefetch_related失效。

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