如何在Django QuerySet中实现ref_id匹配退房日期的类一对多聚合
问题定位
当前代码直接逐条序列化单条Booking记录,每条仅对应单个关联Room,导致同ref_id、同退房日期的多条Booking重复输出ref_id字段,无法生成聚合后的rooms数组结构。
实现方案
方案1:数据库层聚合(性能最优,适配PostgreSQL)
利用Django ORM的数据库聚合能力,直接在查询阶段完成分组与room列表拼接,避免Python层循环开销。
- 导入所需依赖:
from django.db.models import F, Min, Q from django.db.models.functions import JSONObject from django.contrib.postgres.aggregates import ArrayAgg from rest_framework import serializers from rest_framework.views import APIView from rest_framework.response import Response
- 调整序列化器结构,匹配聚合后的数据源:
class RoomSerializer(serializers.ModelSerializer): class Meta: model = Room fields = ('id', 'room_number',) class GroupedBookingSerializer(serializers.Serializer): id = serializers.IntegerField() ref_id = serializers.CharField() check_out_date = serializers.DateField() rooms = serializers.ListField(child=RoomSerializer())
- 调整视图查询逻辑,完成分组聚合:
class ReadBookings(APIView): def get(self, request): # 从请求中获取指定的退房日期参数 check_out_date = request.query_params.get('check_out_date') if not check_out_date: return Response({"detail": "缺少必填的退房日期参数"}, status=400) # 聚合查询:按ref_id+check_out_date分组,拼接同组的room列表 bookings = ( Booking.objects .filter(check_out_date=check_out_date) # 按两个字段分组,去重输出同组条目 .values('ref_id', 'check_out_date') .annotate( # 取同组内最小的Booking id,匹配期望的返回结构 id=Min('id'), # 聚合同组下所有非空的room,生成嵌套列表 rooms=ArrayAgg( JSONObject(id=F('room__id'), room_number=F('room__room_number')), # 过滤掉关联room为空的无效记录 filter=Q(room__isnull=False), distinct=True # 避免重复的room条目 ) ) .order_by('id') ) serializer = GroupedBookingSerializer(bookings, many=True) return Response(serializer.data)
方案2:Python层内存聚合(全数据库兼容)
如果项目使用SQLite、旧版本MySQL等不支持JSON聚合函数的数据库,可在查询完成后在Python内存中完成分组,兼容性更强:
- 序列化器部分和方案1保持一致
- 视图调整为如下逻辑:
from collections import defaultdict class ReadBookings(APIView): def get(self, request): check_out_date = request.query_params.get('check_out_date') if not check_out_date: return Response({"detail": "缺少必填的退房日期参数"}, status=400) # 预加载关联的room,避免循环时触发N+1查询 bookings = Booking.objects.filter(check_out_date=check_out_date).select_related('room') # 用嵌套字典做分组,分组key为(ref_id, check_out_date)元组 grouped_map = defaultdict(lambda: {"rooms": []}) for booking in bookings: group_key = (booking.ref_id, booking.check_out_date) # 首次遍历到该组时,初始化基础字段 if "ref_id" not in grouped_map[group_key]: grouped_map[group_key] = { "id": booking.id, "ref_id": booking.ref_id, "check_out_date": booking.check_out_date, "rooms": [] } # 跳过无关联room的空记录 if booking.room: grouped_map[group_key]["rooms"].append({ "id": booking.room.id, "room_number": booking.room.room_number }) # 转换为列表传给序列化器 result_list = list(grouped_map.values()) serializer = GroupedBookingSerializer(result_list, many=True) return Response(serializer.data)
注意事项
- 分组逻辑必须同时绑定ref_id和check_out_date两个维度,避免不同退房日期的同ref_id记录被错误合并
- Python层聚合时一定要加
select_related('room'),否则每条Booking都会单独查询一次关联room表,产生严重的N+1性能问题 - 因原模型允许room字段为空,聚合时一定要过滤空关联的记录,避免rooms数组中出现None值
内容的提问来源于stack exchange,提问作者Salad.Guyo
相关产品推荐
相关产品推荐

