如何创建自动查询OneToOne关联对象的Django QuerySet？

一、用QuerySet预加载关联对象（避免N+1查询） #

要让QuerySet自动获取关联的Site对象，使用select_related即可——因为OneToOne是一对一正向关联，select_related能一次性把所有关联数据从数据库中查询出来，避免后续访问关联属性时触发额外查询。

代码示例：

# 预加载三个Site关联对象，后续访问site_1/site_2/site_3无需再查库
myapp_queryset = MyApp.objects.select_related('site_1', 'site_2', 'site_3').all()

二、正确序列化关联对象（替代原生JSONSerializer） #

Django原生JSONSerializer默认只序列化外键的主键，无法直接输出完整关联对象，因此需要自定义序列化逻辑，以下两种方式任选：

方式1：使用Django REST Framework（DRF）序列化器（推荐） #

如果项目已引入DRF，这是最简洁的实现方式：

1. 定义Site模型的序列化器：

from rest_framework import serializers
from .models import Site, MyApp

class SiteSerializer(serializers.ModelSerializer):
    class Meta:
        model = Site
        fields = '__all__'  # 可按需指定字段，比如['id', 'name', 'location']

2. 定义MyApp模型的序列化器，关联SiteSerializer：

class MyAppSerializer(serializers.ModelSerializer):
    site_1 = SiteSerializer()
    site_2 = SiteSerializer()
    site_3 = SiteSerializer()

    class Meta:
        model = MyApp
        fields = '__all__'  # 或指定需要的MyApp字段

3. 在视图中使用序列化器返回数据：

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

class MyAppListView(APIView):
    def get(self, request):
        queryset = MyApp.objects.select_related('site_1', 'site_2', 'site_3').all()
        serializer = MyAppSerializer(queryset, many=True)
        return Response(serializer.data)

返回的JSON中，每个site字段都会包含完整的Site对象数据，无需手动拼接。

方式2：手动构造字典（不依赖DRF） #

如果不想引入DRF，可以基于预加载的QuerySet手动构造返回数据：

import json
from django.http import HttpResponse

def myapp_list(request):
    queryset = MyApp.objects.select_related('site_1', 'site_2', 'site_3').all()
    data_list = []
    for app in queryset:
        app_data = {
            'pk': app.pk,
            'title': app.title,
            # 补充其他MyApp字段
            'site_1': {
                'pk': app.site_1.pk,
                'name': app.site_1.name,
                # 补充其他Site字段
            } if app.site_1 else None,
            'site_2': {
                'pk': app.site_2.pk,
                'name': app.site_2.name,
                # 补充其他Site字段
            } if app.site_2 else None,
            'site_3': {
                'pk': app.site_3.pk,
                'name': app.site_3.name,
                # 补充其他Site字段
            } if app.site_3 else None,
        }
        data_list.append(app_data)
    return HttpResponse(json.dumps(data_list), content_type='application/json')

这种方式需要手动指定每个字段，但无需依赖第三方库，且基于预加载的QuerySet，性能比之前手动拼接的方式更优。

三、原生JSONSerializer的局限性 #

Django原生JSONSerializer的设计目标是序列化模型的基础字段，对于外键、一对一这类关联字段，默认仅输出关联对象的主键值，没有内置配置支持直接输出完整关联对象，因此必须通过自定义序列化逻辑实现需求。

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