pymongo 4.x 默认禁用 tls 1.0/1.1，要求 mongodb 4.2+ 集群启用 tls，旧集群需降级至 pymongo 3.12；mongodb+srv:// 必须含正确 srv 记录、url 编码凭据及 ?retrywrites=true&w=majority 参数。
pip install pymongo 之后连不上集群？先确认版本和依赖
PyMongo 4.x 默认禁用 TLS 1.0/1.1，且要求 MongoDB 4.2+ 集群开启 TLS（即必须用 mongodb+srv:// 或显式配置 tls=True）。如果你用的是旧版集群（如 3.6）或内网无 TLS 环境，得降级到 PyMongo 3.12：
pip install "pymongo否则会卡在连接握手，错误信息类似 <code>ServerSelectionTimeoutError: No servers found</code> 或直接抛 <code>ConfigurationError: tlsCAFile requires TLS to be enabled</code>。 <h3> <a style="color:#f60; text-decoration:underline;" title="mongodb" href="https://m.php.cn/zt/16002.html" target="_blank">mongodb</a>+srv:// 连接字符串里哪些参数不能少？</h3> <p><code>mongodb+srv://</code> 不是可选语法糖，而是强制启用 DNS SRV 记录发现机制——它会自动查出所有 mongos 或 replica set 成员地址，省去手动列 host 的麻烦。但必须满足：</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5179" title="Python Packaging"><img src="https://img.php.cn/upload/skill/000/000/081/179039528667188.jpg" alt="Python Packaging" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill5179" title="Python Packaging" class="overflowclass">Python Packaging</a> <p class="overflowclass">深度Python打包工作流——pyproject元数据、依赖与可选额外项、构建后端、wheel、版本控制、发布及CI发布规范……</p> </div> <a rel="nofollow" href="/xiazai/skill5179" title="Python Packaging" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>
- 域名已配置正确的 SRV 记录（格式为
_mongodb._tcp.your-cluster.mongodb.net） - 用户名密码 URL 编码（空格、
@、/等必须用urllib.parse.quote_plus()处理） - 末尾必须带
?retryWrites=true&w=majority（新集群默认要求写关注）
"mongodb+srv://user:pass%40123@cluster-abc.mongodb.net/?retryWrites=true&w=majority"
连接时 timeout 和 maxPoolSize 怎么设才不拖慢服务？
默认 maxPoolSize=100 在高并发 Web 服务中容易耗尽文件描述符；而 connectTimeoutMS=20000（默认 20 秒）会让请求卡太久。生产环境建议：
- 设置
connectTimeoutMS=5000和serverSelectionTimeoutMS=3000，快速失败 -
maxPoolSize按应用线程/协程数 × 2～3 设置（如 FastAPI 默认 4 个 worker，设为 20 即可） - 务必加
minPoolSize=5，避免冷启动时反复建连
client = MongoClient( "mongodb+srv://...", connectTimeoutMS=5000, serverSelectionTimeoutMS=3000, maxPoolSize=20, minPoolSize=5, retryWrites=True)
为什么第一次查询总慢，之后就快了？
这不是缓存，是 PyMongo 的 lazy initialization：Client 实例创建时不真正连服务器，直到第一次执行 find()、insert_one() 等操作时才触发 DNS 查询、TLS 握手、server discovery。如果你在 Flask 的 app.py 顶层创建 client，但路由里首次调用才真正连，就会感知到延迟。解决方法只有两个：
- 在初始化 client 后立刻执行一次轻量操作，比如
client.admin.command("ping") - 把 client 创建移到应用启动逻辑里（如 FastAPI 的
startupevent），并主动 ping
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
