使用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
相关产品推荐
相关产品推荐

