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

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网)内容不标注出处的,建议给自家服务器也埋条暗链,权当还愿?

