ServerSelectionTimeoutError主因是连接字符串或网络策略问题，需检查host/port/认证信息、DNS解析、端口连通性、bindIp配置、authSource参数及云服务白名单，并用telnet和serverSelectionTimeoutMS=3000快速定位故障层。
PyMongo 连不上 MongoDB，报 ServerSelectionTimeoutError，八成不是代码写错了，而是连接字符串或网络策略拦住了请求。
检查连接字符串是否含有效 host、port 和认证信息
这个错误表面是“选不到可用服务器”，根源常是 DNS 解析失败、端口不通，或连接字符串压根没指向真实运行的实例。
-
mongodb://localhost:27017在 Docker 或远程部署时基本无效——localhost指的是当前容器/本机，不是 MongoDB 所在机器 - 用 IP 替代
localhost时，确认 MongoDB 配置了bindIp（如bindIp: 0.0.0.0），否则只监听本地回环 - 带认证的连接必须包含
username、password和authSource，例如：mongodb://myuser:mypass@192.168.1.10:27017/mydb?authSource=admin - URL 中漏掉
?retryWrites=false不会直接导致超时，但旧版驱动在某些云服务（如 Atlas）上可能因默认重试逻辑加剧超时表现
确认 MongoDB 服务端是否允许你的 IP 访问（白名单）
云数据库（如 MongoDB Atlas、阿里云 MongoDB）默认关闭公网访问，且强制白名单控制。本地测试连得通，一上云就报错，大概率卡在这步。
- 登录对应云控制台，在「网络访问」或「IP 白名单」页面添加你的出口 IP（不是内网 IP）
- 开发阶段可临时加
0.0.0.0/0测试，但上线前必须收紧——这不安全，且部分云厂商禁止该写法 - 如果你在公司内网或使用代理，实际出口 IP 可能和本地
curl ifconfig.me不一致；建议用云厂商提供的「诊断工具」或直接在服务器上跑curl https://httpbin.org/ip确认 - 某些 VPC 内网部署场景下，需确保 MongoDB 实例与应用实例处于同一安全组，且安全组入方向放行了
27017（或自定义端口）
用 pymongo.MongoClient 的 timeout 参数快速验证网络层问题
默认连接超时约 30 秒，太长不利于排查。缩短它，能更快区分是配置问题还是网络阻塞。
立即学习“Python免费学习笔记（深入）”；
- 初始化客户端时显式设
serverSelectionTimeoutMS=3000（3 秒）：client = MongoClient("mongodb://...", serverSelectionTimeoutMS=3000) - 紧接着调用
client.admin.command('ping')触发真实连接，捕获异常：try: client.admin.command('ping') except ServerSelectionTimeoutError as e: print("连接失败：", str(e)) # 此时错误信息里通常含具体 host:port - 如果超时发生在
ping前，说明MongoClient初始化阶段就卡住——基本可断定 DNS 或路由不通；如果ping报错但提示已连接到某 IP，则可能是认证失败或权限不足（此时错误类型会变成OperationFailure）
真正麻烦的不是写错一个参数，而是错误信息不告诉你到底卡在哪一层：DNS？防火墙？MongoDB 配置？云白名单？还是 TLS 版本不匹配？每次遇到 ServerSelectionTimeoutError，优先拿 telnet 或 nc 直连目标 IP 和端口，比翻代码快得多。
