Django多模型序列化优化：用Serializer及select_related降查询耗时

核心思路 #

替换SerializerMethodField为嵌套序列化器，结合select_related预取关联数据消除N+1查询，关键是保证序列化器字段与模型关联字段匹配，同时正确使用查询集预取方法。

步骤与代码示例 #

1. 确认模型关联关系

假设你的模型结构如下（可根据实际调整）：

from django.db import models

class School(models.Model):
    name = models.CharField(max_length=100)
    address = models.CharField(max_length=200)

class Site(models.Model):
    name = models.CharField(max_length=100)
    # 外键关联School，字段名为school（关键，后续要对应）
    school = models.ForeignKey(School, on_delete=models.CASCADE)

2. 编写正确的嵌套序列化器

直接在主序列化器中关联SiteSchoolSerializer，字段名必须与模型中的关联字段完全一致：

from rest_framework import serializers
from .models import Site, School

class SiteSchoolSerializer(serializers.ModelSerializer):
    class Meta:
        model = School
        fields = ['id', 'name', 'address']  # 按需选择返回字段

class SiteSerializer(serializers.ModelSerializer):
    # 关联字段名与模型外键字段名一致：school
    school = SiteSchoolSerializer(read_only=True)

    class Meta:
        model = Site
        fields = ['id', 'name', 'school']  # 包含关联字段

3. 配置视图的预取查询集

使用select_related预取关联的School数据，参数与模型关联字段名一致：

from rest_framework import viewsets
from .models import Site
from .serializers import SiteSerializer

class SiteViewSet(viewsets.ReadOnlyModelViewSet):
    # 预取school关联数据，避免N+1查询
    queryset = Site.objects.select_related('school').all()
    serializer_class = SiteSerializer

常见错误排查 #

• 字段名不匹配：序列化器中嵌套字段的名称必须和模型关联字段（如外键字段名）完全一致，不能自定义名称，否则会触发"字段不存在"错误。
• 预取方法误用：select_related仅适用于一对一、正向外键关联；如果是多对多或反向外键关联，需改用prefetch_related。
• 未设置read_only：嵌套序列化器用于读取数据时，必须添加read_only=True，否则在创建/更新操作时会要求提交关联字段数据，导致校验错误。
• 反向关联处理：如果需要从School序列化关联的Site，需在SchoolSerializer中添加sites = SiteSerializer(many=True, read_only=True)，同时查询集改为School.objects.prefetch_related('sites').all()（需确保Site模型的外键设置了related_name='sites'）。

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