在Django异步查询中如何获取模型实例的外键及多对多属性？

API 探路者

2026-8-11

修复Django异步场景中外键与多对多属性访问的错误

出现这个错误的核心原因是：在Django异步上下文里，直接访问外键或多对多关联属性会触发同步数据库查询（关联关系默认是懒加载），而Django禁止在异步上下文内执行同步数据库操作。下面提供两种可行的修复方案：

方案一：预取关联数据（推荐，性能更优）

通过select_related（针对外键/一对一关系）和prefetch_related（针对多对多/反向外键关系）提前预取所有需要的关联数据，这样在异步循环中访问关联属性时，不会触发新的同步查询。

修改后的代码如下：

import asyncio

async def main():
    # 预取外键university和多对多courses的数据
    async for student in Student.objects.select_related('university').prefetch_related('courses'):
        print(student.name)
        # 已预取，直接访问不会触发同步查询
        print(student.university.name)
        # courses已预取，遍历无需额外操作
        for course in student.courses.all():
            print(course.name)

asyncio.run(main())

方案二：用`sync_to_async`包装同步操作

如果场景不适合预取数据，可以使用asgiref.sync.sync_to_async将访问关联属性的同步操作包装成异步操作，让其在单独线程中执行。

修改后的代码如下：

import asyncio
from asgiref.sync import sync_to_async

async def main():
    async for student in Student.objects.all():
        print(student.name)
        
        # 包装外键属性的访问操作
        university_name = await sync_to_async(lambda: student.university.name)()
        print(university_name)
        
        # 包装多对多查询并转为列表
        courses = await sync_to_async(list)(student.courses.all())
        for course in courses:
            print(course.name)

asyncio.run(main())