PyMongo 4.6+ 明确支持 Python 3.12，但连接池为同步阻塞式，非 asyncio 原生；硬混用会导致 event loop 卡顿，应全局复用 MongoClient 实例、设 maxPoolSize=20 起步并配 minPoolSize=5 和 maxIdleTimeMS=60000，避免连接泄漏与服务端拒绝。
PyMongo 4 连接池默认行为与 3.12 的兼容性要点
Python 3.12 对 asyncio 和 GC 机制有小幅调整，但 PyMongo 4.6+ 已明确支持 3.12，无需降级或打补丁。关键在于：PyMongo 的连接池是同步阻塞式（非 asyncio 原生），即使在 3.12 中运行，Motor 才是异步选型；若硬用 pymongo.MongoClient 配合 asyncio，会因线程阻塞导致 event loop 卡顿——这不是 bug，是设计使然。
实操建议：
- 确认 PyMongo 版本 ≥ 4.6：
pip show pymongo，低于则升级：pip install --upgrade pymongo>=4.6 - 避免在
async def函数里直接调用collection.find_one()等同步方法；如必须混用，用loop.run_in_executor包裹 - 检查是否误启用了
tlsAllowInvalidCertificates=True等调试参数，3.12 下 TLS 握手更严格，可能触发ConnectionFailure: TLS handshake failed
连接池大小（maxPoolSize）和超时参数的实际调优逻辑
maxPoolSize 不是“越大越好”，它受 OS 文件描述符限制和 MongoDB 服务端 maxConns 约束。默认值 100 在多数 Web 应用中偏高，尤其当每个请求都新建 MongoClient 实例时，极易触发 ConnectionResetError 或服务端拒绝新连接。
实操建议：
- 全局复用单个
MongoClient实例（推荐放在模块顶层或依赖注入容器中），而非每次请求 new 一个 - 设
maxPoolSize=20起步，观察应用进程的lsof -p PID | grep mongodb | wc -l输出；若长期接近该值，再小幅上调 - 必须配
minPoolSize=5（PyMongo 4.4+ 支持），避免突发流量时频繁建连；同时设maxIdleTimeMS=60000防止空闲连接堆积 -
connectTimeoutMS=5000和socketTimeoutMS=30000要匹配业务 SLA，过短会导致重试风暴，过长拖垮请求链路
如何验证连接池是否真正复用、是否存在泄漏
光看配置没用。PyMongo 提供了 client.options.pool_options 和运行时统计接口，但容易被忽略的是：连接池状态只反映客户端视角，无法直接看到服务端真实连接数。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
- 启用日志观察建连行为：
import logging; logging.basicConfig(level=logging.DEBUG)，搜索日志中是否高频出现Created new connection - 运行时检查：
client.admin.command("serverStatus")["connections"]查服务端总连接数；对比len(client._topology._servers)（需访问私有属性，仅调试用） - 写个小脚本压测：启动后立刻调
client.options.pool_options.max_pool_size次collection.find_one({})，再 sleep 2 秒，接着再查一次——若第二次仍维持满连接，说明minPoolSize或maxIdleTimeMS未生效 - 警惕 ORM 封装层（如 MongoEngine）自动创建新 client，务必确认其底层是否复用你传入的实例
副本集故障转移时连接池的行为与应对
PyMongo 4 默认开启 heartbeatFrequencyMS=10000（每 10 秒探活），但故障识别不是瞬时的。若主节点宕机，客户端可能在下一个心跳周期前仍向旧主发请求，抛出 NotPrimaryError 或 AutoReconnect 异常——这不是连接池失效，而是驱动在等待拓扑更新。
实操建议：
- 显式设置
replicaSet参数（即使单节点也建议加），否则 PyMongo 不启用副本集模式，故障转移完全不工作 - 捕获
pymongo.errors.NotPrimaryError和pymongo.errors.AutoReconnect，做简单重试（最多 1 次），不要无脑循环重试 - 避免在事务中跨多文档操作时使用长耗时逻辑，
maxTransactionTimeMS默认 60 秒，超时会强制中止并释放连接，导致池内连接状态混乱 - 测试故障转移不能只 kill 主进程，要模拟网络分区（如
iptables -A OUTPUT -d TARGET_IP -j DROP），否则驱动可能走本地缓存绕过检测
最常被忽略的一点：PyMongo 连接池不感知 DNS 变更。如果用 SRV 记录或负载均衡 VIP，DNS TTL 缓存更新后，老连接仍维持到原 IP，新连接才走新地址——这意味着滚动更新 MongoDB 后，得主动重启应用进程，或调用 client.close() + 重建实例，不能只靠连接池自动刷新。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
