异步Django中调用len获取ORM查询集长度报错，如何异步实现？

问题原因 #

你用@sync_to_async包装的get_invites方法返回的是Django的QuerySet对象，而QuerySet是惰性加载的——调用len()时才会实际执行数据库查询，这个查询操作属于同步操作，不能直接在异步上下文执行，因此触发SynchronousOnlyOperation错误。

解决方案 #

方案1：在同步方法内直接返回计数（推荐）

修改get_invites方法，用count()直接返回查询结果的数量，避免返回QuerySet后再在异步上下文处理：

@sync_to_async
def get_invites_count(self, inviter):
    return Invite.objects.filter(inviter=inviter).count()

调用时直接使用返回的数值：

invite_count = await InviteLogic.get_invites_count(self.app.user)
if invite_count > 0:
    ...

这种方式更高效，因为count()会触发数据库的COUNT聚合查询，比查询全部记录再计算长度性能更好。

方案2：将QuerySet转为列表后返回

如果确实需要获取完整的查询集数据，可以在同步方法内将QuerySet转为列表，提前执行查询：

@sync_to_async
def get_invites(self, inviter):
    return list(Invite.objects.filter(inviter=inviter))

此时异步调用后得到的是普通列表，直接调用len()不会触发同步数据库操作：

invites = await InviteLogic.get_invites(self.app.user)
if len(invites) > 0:
    ...

方案3：使用Django原生异步ORM（Django 3.1+）

如果你的Django版本在3.1及以上，可以直接使用异步ORM方法，无需sync_to_async包装：

# 异步过滤获取查询集
invites = await Invite.objects.afilter(inviter=self.app.user)
# 异步获取计数
invite_count = await invites.acount()
if invite_count > 0:
    ...

这是Django官方推荐的异步场景解决方案，完全适配异步上下文。

内容的提问来源于stack exchange，提问作者Lex Podgorny