Motor 3.0+ 完全支持 Python 3.11，需升级至 motor>=3.0.0，禁用 io_loop 参数，统一使用 async/await 语法，AsyncIOMotorClient 应全局复用并 await 验证连接与操作。
Motor 3.0+ 已完全支持 Python 3.11，但默认安装的 motor 包不带异步 I/O 事件循环绑定——你必须显式传入 io_loop 或（更推荐）直接用 async/await 风格，否则会卡死或抛 RuntimeError: There is no current event loop。
确认 Motor 版本与 Python 3.11 兼容性
Motor 2.x 不支持 Python 3.11 的原生 async 语法（如 async for 遍历游标），必须升级到 motor>=3.0.0。检查方式：
pip show motor
若版本低于 3.0，请升级：
pip install --upgrade motor- 注意：Motor 3.x 不再兼容 Tornado 5.x 或 asyncio 旧版，确保你的环境有
asyncio（Python 3.11 自带） - 卸载残留的
tornado低版本可避免隐式事件循环冲突
初始化 AsyncIOMotorClient 的正确写法
不要用 io_loop=asyncio.get_event_loop() —— Python 3.11 中该方法已弃用，且在子线程中调用会报错。应使用 asyncio.get_running_loop() 或直接依赖 Motor 内部自动检测：
立即学习“Python免费学习笔记（深入）”；
- ✅ 推荐（简洁安全）：
client = AsyncIOMotorClient("mongodb://localhost:27017") - ⚠️ 慎用：
client = AsyncIOMotorClient(..., io_loop=asyncio.get_running_loop())—— 仅在明确处于运行中的 event loop 里才有效 - ❌ 错误：
io_loop=asyncio.get_event_loop()在 Python 3.11+ 会触发DeprecationWarning并可能失效
连接后务必 await client.admin.command("ping") 验证，而非仅靠构造函数。
执行 find()、insert_one() 等操作时的 await 必须项
Motor 的所有 I/O 方法返回的是协程对象（coroutine object），不是结果。漏掉 await 是 Python 3.11 下最常见静默失败原因：
-
cursor = collection.find({})→ 得到的是AsyncIOMotorCursor，不是数据；必须await cursor.to_list(length=100)或async for doc in cursor: -
result = collection.insert_one({...})→ 必须await result才能拿到InsertOneResult，否则result.inserted_id是None - 聚合管道同样：
pipeline = [{"$match": {...}}]; await collection.aggregate(pipeline).to_list(10)
错误示例（无 await）会导致程序立刻退出或返回空结果，且无明显报错。
在 FastAPI 或独立脚本中运行的注意事项
FastAPI 默认使用 asyncio.run() 启动，Motor 可直接工作；但独立脚本需手动启动 event loop：
- ✅ 正确启动方式（Python 3.11+）：
import asyncio<br>from motor.motor_asyncio import AsyncIOMotorClient<br><br>async def main():<br> client = AsyncIOMotorClient("mongodb://localhost:27017")<br> db = client.test<br> await db.test_collection.insert_one({"x": 1})<br><br>asyncio.run(main()) - ❌ 不要再用
loop = asyncio.get_event_loop(); loop.run_until_complete(main())—— Python 3.11 已移除get_event_loop()的全局 loop 绑定 - 连接池复用：
AsyncIOMotorClient实例应全局单例，不要每次请求都新建，否则耗尽 socket 或触发ConnectionResetError
真正容易被忽略的是：MongoDB 连接字符串里的 ?retryWrites=true 在某些副本集配置下会与 Motor 3.x 的 write concern 行为冲突，测试阶段建议先去掉。
