解决Django Admin嵌套详情Inline中的N+1查询问题

问题核心原因 #

直接使用prefetch_related('children')仅能预取父模型关联的子对象，但子对象自身的关联字段仍会触发额外查询。需要通过Prefetch对象嵌套预取，一次性拉取所有层级的关联数据。

示例代码实现 #

1. 假设的模型结构

from django.db import models

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

class Child(models.Model):
    # 关联父模型Statistic
    statistic = models.ForeignKey('Statistic', on_delete=models.CASCADE, related_name='children')
    # 子模型的关联字段，这是触发N+1的关键
    other_model = models.ForeignKey(OtherModel, on_delete=models.CASCADE)
    value = models.IntegerField()

class Statistic(models.Model):
    date = models.DateField()
    # 其他业务字段

2. Admin配置（核心解决代码）

from django.contrib import admin
from django.db.models import Prefetch
from .models import Statistic, Child, OtherModel

class ChildInline(admin.TabularInline):
    model = Child
    # 展示子模型的关联字段和业务字段
    fields = ('other_model', 'value')
    extra = 0

@admin.register(Statistic)
class StatisticAdmin(admin.ModelAdmin):
    inlines = [ChildInline]

    def get_queryset(self, request):
        qs = super().get_queryset(request)
        # 关键：用Prefetch指定预取子对象时，同时拉取子对象的关联字段
        qs = qs.prefetch_related(
            Prefetch(
                'children',
                # 子对象的查询集提前通过select_related拉取关联的OtherModel
                queryset=Child.objects.select_related('other_model')
            )
        )
        return qs

特殊场景适配 #

如果子模型的关联是ManyToManyField，把select_related换成prefetch_related即可：

# 子模型中的ManyToMany关联
class Child(models.Model):
    statistic = models.ForeignKey('Statistic', on_delete=models.CASCADE, related_name='children')
    other_models = models.ManyToManyField(OtherModel)
    value = models.IntegerField()

# Admin中的Prefetch修改
Prefetch(
    'children',
    queryset=Child.objects.prefetch_related('other_models')
)

验证方法 #

使用Django Debug Toolbar查看页面加载时的SQL查询次数，确认原本的N+1查询已合并为少量几次批量查询。

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