Django多表关联查询与序列化：从指定SomeItem列表获取关联数据

一、编写查询集语句 #

假设你有指定的SomeItem ID列表（比如some_item_ids = [1,2,3]），可以通过以下查询集一次性获取所需关联数据，避免N+1查询问题：

首先建议给SomeOtherItem模型的外键字段添加related_name，简化反向关联调用：

class SomeOtherItem(models.Model):
    transaction_status = models.CharField(max_length=200, default='INITIATED')
    # 添加related_name，方便后续调用
    some_item = models.ForeignKey(SomeItem, on_delete=models.CASCADE, unique=True, related_name='some_other_item')

然后编写查询集：

from django.db.models import Prefetch

# 过滤目标SomeItem，同时关联查询Customer、User，预取对应的SomeOtherItem
some_items = SomeItem.objects.filter(id__in=some_item_ids).select_related(
    'customer__user'  # 一次性拉取关联的Customer和User数据
).prefetch_related(
    'some_other_item'  # 预取反向关联的SomeOtherItem（因unique=True，每个SomeItem最多对应一个）
)

如果不修改模型添加related_name，可以用默认的反向关联名称someotheritem_set，查询集调整为：

some_items = SomeItem.objects.filter(id__in=some_item_ids).select_related(
    'customer__user'
).prefetch_related(
    Prefetch('someotheritem_set', queryset=SomeOtherItem.objects.all(), to_attr='some_other_item')
)

二、编写序列化器 #

通过嵌套序列化器解析关联数据，将查询结果转为Python字典：

1. User序列化器（提取指定字段） #

from rest_framework import serializers
from .models import User, SomeItem, SomeOtherItem

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['first_name', 'last_name']

2. SomeOtherItem序列化器（返回全部字段） #

class SomeOtherItemSerializer(serializers.ModelSerializer):
    class Meta:
        model = SomeOtherItem
        fields = '__all__'

3. 主序列化器（整合所有数据） #

如果添加了related_name='some_other_item'，主序列化器写法：

class SomeItemSerializer(serializers.ModelSerializer):
    # 从Customer关联到User，映射为user字段
    user = UserSerializer(source='customer.user')
    # 关联SomeOtherItem，允许为空
    some_other_item = SomeOtherItemSerializer(required=False, allow_null=True)

    class Meta:
        model = SomeItem
        fields = '__all__' + ['user', 'some_other_item']  # 包含SomeItem全部字段+关联字段

如果未添加related_name，则调整为：

class SomeItemSerializer(serializers.ModelSerializer):
    user = UserSerializer(source='customer.user')
    # 从someotheritem_set中取唯一的对象（因unique=True）
    some_other_item = SomeOtherItemSerializer(source='someotheritem_set.first', required=False, allow_null=True)

    class Meta:
        model = SomeItem
        fields = '__all__' + ['user', 'some_other_item']

三、API视图中使用示例 #

from rest_framework.views import APIView
from rest_framework.response import Response

class SomeItemDataAPI(APIView):
    def get(self, request):
        # 从请求参数获取目标SomeItem的ID列表
        target_item_ids = request.query_params.getlist('item_ids', [])
        # 执行查询
        queryset = SomeItem.objects.filter(id__in=target_item_ids).select_related(
            'customer__user'
        ).prefetch_related('some_other_item')
        # 序列化数据
        serializer = SomeItemSerializer(queryset, many=True)
        return Response(serializer.data)

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