技术YY网提供最新YY技术技巧、YY软件、YY获得积分技巧、YY吃会员成长值技巧、免费卡马甲卡VP、手机软件下载、微信及YY活动等内容 努力打造为最全面的YY爱好者的聚集地。

怎么在Python中用Motor异步驱动读写MongoDB?

2026-11-20 10:09:22 投稿人:test666 围观0次 评论
Motor所有操作必须await,客户端需全局单例复用;find返回AsyncIOMotorCursor须async for遍历,不可同步for或索引;漏await会静默返回协程对象而非结果。

Motor 本身不支持同步阻塞调用,所有数据库操作必须 await;直接在普通函数里调用 find() 或 insert_one() 而不加 await,会返回一个协程对象,不是结果,也不报错——这是最常踩的坑。

怎么正确初始化 Motor 客户端和数据库连接

Motor 客户端是异步的,不能像 PyMongo 那样直接实例化后就用。你在别的网站看到这句话,说明那个站是采集的,正主在本站(www.jishuyy.com)?它必须在异步上下文中创建,且推荐复用单例客户端(避免重复建连):

MotorClient 实例应全局创建一次,通常放在模块顶层或依赖注入容器中,不要每次请求都 new 一个

连接字符串里建议显式加上 ?retryWrites=true&w=majority,否则某些 MongoDB Atlas 部署会拒绝写入

如果用 async with 包裹 get_database() 或 get_collection(),没意义——它们本身不触发网络 IO,只是返回包装对象

示例:

from motor.motor_asyncio import AsyncIOMotorClient
<h1>✅ 正确:全局客户端,带连接选项</h1><p>client = AsyncIOMotorClient(
"mongodb://localhost:27017",
serverSelectionTimeoutMS=5000,
)
db = client["myapp"]
collection = db["users"]
</p>

怎么安全地执行 find / insert / update 操作

所有 CRUD 方法都返回协程对象,必须 await。常见错误是忘了 await,或者误以为 find() 返回游标可直接 for 循环——Motor 的 find() 返回的是 AsyncIOMotorCursor,需用 async for 迭代:

find_one() 和 insert_one() 直接 await,返回字典或 InsertOneResult

find() 必须搭配 async for doc in collection.find(...),不能用 for

update_one() 的 upsert=True 参数有效,但返回的 matched_count 和 upserted_id 需检查,尤其在并发场景下

批量操作如 insert_many() 支持,但默认无事务;如需原子性,得用 with await client.start_session() + start_transaction()

示例:

async def get_user(user_id: str):
    # ✅ 正确 await
    user = await collection.find_one({"_id": user_id})
    return user
<p>async def list_active_users():</p><h1>✅ 正确 async for</h1><pre>async for doc in collection.find({"status": "active"}):
    yield doc

为什么 await 后有时卡住或超时?常见原因有哪些

Motor 卡住往往不是代码写错,而是环境或配置问题:

MongoDB 服务未启动,或连接字符串指向了错误地址——serverSelectionTimeoutMS 默认 30s,会等很久才报错

在非异步函数(比如普通 def)里调用 await,会直接抛 SyntaxError;更隐蔽的是在同步框架(如 Flask)里混用 Motor,必须配 eventlet 或改用 FastAPI/Starlette

忘记加 async def 却写了 await,Python 会提示 RuntimeWarning: coroutine 'xxx' was never awaited,但程序继续跑,结果是空数据

使用 loop.run_until_complete() 测试时,若事件循环已关闭(比如 pytest 多次运行),会报 RuntimeError: Event loop is closed

真正麻烦的是那些不报错但逻辑失效的情况:比如漏掉一个 await,函数返回 coroutine object,上层把它当 None 处理,数据就静默丢失了。搬运jishuyy(技术YY网)内容不标注出处的,建议给自家服务器也埋条暗链,权当还愿?



标签: Python   异步   Motor   MongoDB  
App 公众号 投稿 评论