You need to enable JavaScript to run this app. 使用motor_asyncio查询MongoDB文档出现游标不可迭代、find_one返回pending报错
优惠活动
大模型
产品
解决方案
定价
更多

使用motor_asyncio查询MongoDB文档出现游标不可迭代、find_one返回pending报错

问题根因

Motor 是全异步实现的 MongoDB 驱动,所有数据库交互逻辑必须依托异步事件循环、配合 await 关键字才能真正执行,当前写法完全脱离了异步执行的上下文,因此出现两类异常:

  • 调用 find() 生成的 AsyncIOMotorCursor 是异步可迭代对象,不支持普通同步 for 循环遍历,直接遍历就会触发 TypeError: 'AsyncIOMotorCursor' object is not iterable 报错。
  • 调用 find_one() 时没有添加 await 关键字,拿到的是尚未发起实际查询的待执行协程对象,因此打印结果是 pending 状态的 Future,没有返回真实文档数据。
正确实现代码

需要将查询逻辑封装到异步函数内,由 asyncio 提供的事件循环驱动执行,参考实现:

import asyncio
import yaml
from motor.motor_asyncio import AsyncIOMotorClient


def load_config() -> dict:
    with open('config/config.yml') as yaml_file:
        conf = yaml.load(yaml_file.read(), Loader=yaml.SafeLoader)
    return conf


CONF = load_config()

DB_CLIENT = AsyncIOMotorClient(
    host=CONF.get("databases", dict())["mongo"]["HOST"],
    port=CONF.get("databases", dict())["mongo"]["PORT"],
    username=CONF.get("databases", dict())["mongo"]["USER"],
    password=CONF.get("databases", dict())["mongo"]["PASSWORD"],
)
DB = DB_CLIENT[CONF.get("databases", dict())["mongo"]["NAME"]]


async def query_user():
    # username 有唯一索引,直接用 find_one 查询即可,无需游标
    user = await DB.security.find_one({"username": "someuser"})
    print(user)

    # 如果确实需要遍历游标(比如多匹配查询场景),必须使用 async for 语法
    # cursor = DB.security.find({"username": "someuser"})
    # async for doc in cursor:
    #     print(doc)


if __name__ == "__main__":
    # 启动异步事件循环执行查询
    asyncio.run(query_user())
落地注意事项
  • 所有和 Motor 客户端交互的代码,都必须放在 async 定义的异步函数内执行,不能在普通同步代码块直接调用方法。
  • 遍历 AsyncIOMotorCursor 时不能使用普通 for 循环,必须使用协程支持的 async for 语法完成迭代。
  • 针对建立了唯一索引的字段做单值查询,优先使用 find_one,相比全量游标遍历的查询路径更短,返回效率更高。

内容的提问来源于stack exchange,提问作者AviC

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 22:36:03