Django异步环境下嵌套模型关联字段加载问题

模型定义 #

class ObjectA(models.Model):
    alias = models.CharField(max_length=50)
    objectb = models.ForeignKey(ObjectB, on_delete=models.PROTECT)

    class Meta:
        db_table = "objecta"

class ObjectB(models.Model):
    name = models.CharField(max_length=50)
    objectc = models.ForeignKey(ObjectC, on_delete=models.PROTECT)

    class Meta:
        db_table = "objectb"

class ObjectC(models.Model):
    name = models.CharField(max_length=50)

    class Meta:
        db_table = "objectc"

问题场景 #

在同步Django中，可直接链式访问关联字段：

get_object_or_404(ObjectA, alias="My alias").objectb.objectc.name

但在异步视图/ViewSet中执行这段代码会抛出错误：

django.core.exceptions.SynchronousOnlyOperation: You cannot call this from an async context - use a thread or sync_to_async.

简洁解决方案 #

方案1：异步查询集 + select_related #

利用Django异步查询集API，结合select_related提前预加载关联模型，避免后续同步访问触发错误：

from django.http import Http404

try:
    # 通过select_related一次性加载objectb和objectc关联数据
    objecta = await ObjectA.objects.select_related('objectb__objectc').aget(alias="My alias")
    c_name = objecta.objectb.objectc.name
except ObjectA.DoesNotExist:
    raise Http404

方案2：sync_to_async包装get_object_or_404并预加载关联 #

如果习惯使用get_object_or_404，可将其包装为异步函数，同时在查询集里提前预加载关联：

from asgiref.sync import sync_to_async
from django.shortcuts import get_object_or_404

# 包装同步的get_object_or_404为异步函数
get_objecta = sync_to_async(get_object_or_404, thread_sensitive=True)
# 传入带select_related的查询集，一次性获取关联数据
objecta = await get_objecta(ObjectA.objects.select_related('objectb__objectc'), alias="My alias")
c_name = objecta.objectb.objectc.name

优化说明 #

你之前的方案使用aprefetch_related_objects虽然可行，但select_related更适配ForeignKey这类多对一关联——它通过SQL JOIN一次性拉取关联数据，代码更简洁且性能更优，无需额外的预加载步骤。

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