ServerSelectionTimeoutError本质是PyMongo无法连接任何可用MongoDB节点，需先确认服务运行状态、网络连通性、bindIp配置、连接字符串格式及版本兼容性，再排查副本集参数、DNS解析、防火墙或容器网络问题。
确认MongoDB服务是否真正运行并可被Python访问
ServerSelectionTimeoutError 本质是驱动连不上任何可用节点，不是认证失败也不是语法错误。先别急着改代码，检查服务状态和网络连通性。
- 在终端执行
mongod --version确认 MongoDB 已安装且版本兼容（PyMongo 4.x 推荐 MongoDB 4.2+） - 运行
ps aux | grep mongod（macOS/Linux）或打开 Windows 服务管理器，确认mongod进程正在运行 - 用
mongo --host localhost:27017手动连接测试——如果这里就超时，说明问题出在服务端或本地防火墙 - 检查是否启用了非默认端口或绑定地址：查看
/etc/mongod.conf（Linux/macOS）或C:\Program Files\MongoDB\Server\X.X\bin\mongod.cfg（Windows），确认bindIp包含127.0.0.1或0.0.0.0，而非仅127.0.0.1却被防火墙拦截
检查 PyMongo 连接字符串和参数是否匹配部署模式
单机、副本集、分片集群的连接方式差异极大，写错一个参数就会触发 ServerSelectionTimeoutError。
- 单机连接必须用
mongodb://localhost:27017，不能漏掉mongodb://前缀，也不能多写斜杠（如mongodb:///） - 副本集连接需显式指定
replicaSet名称，且该名称必须与mongod启动时的--replSet值完全一致：mongodb://host1:27017,host2:27017/?replicaSet=my-rs - 若使用 Docker 或云服务（如 MongoDB Atlas），注意默认开启 TLS/SSL：必须加
?tls=true&tlsCAFile=...，否则驱动会卡在握手阶段，表现为超时而非证书错误 - 避免滥用
serverSelectionTimeoutMS：设成 5000 是调试友好，但生产环境不要盲目调大——它掩盖的是根本连不通的问题
验证 DNS 解析和 hostname 可达性（尤其在容器或远程部署中）
PyMongo 默认启用 SRV 记录解析，且对 hostname 敏感。localhost 在容器内可能不指向宿主机，DNS 缓存也可能导致旧 IP 生效。
- 把连接字符串里的
localhost换成127.0.0.1——二者在某些 Docker 网络模式下行为不同 - 在 Python 中临时加诊断代码：
import socket<br>print(socket.gethostbyname("your-hostname"))，确认解析结果是你期望的 IP - 若用 Kubernetes 或 Docker Compose，确保 service name 能被正确解析，且目标 Pod 的
mongod正在监听0.0.0.0:27017而非仅127.0.0.1:27017 - 禁用 SRV 解析以防干扰：
mongodb+srv://...格式只用于 Atlas；自建集群必须用mongodb://，否则 PyMongo 会尝试查 _mongodb._tcp DNS 记录并失败
排查 PyMongo 版本与 MongoDB 协议兼容性
PyMongo 4.0+ 默认使用 MongoDB 5.0+ 的协议特性，老版本服务端可能拒绝协商，静默表现为连接超时。
立即学习“Python免费学习笔记（深入）”；
- 运行
pip show pymongo，若版本 ≥ 4.0，而 MongoDB 服务是 3.6 或更早，请降级：pip install "pymongo - 检查 MongoDB 日志是否有
Unsupported wire version或client metadata missing类似报错——这是协议不匹配的典型信号 - PyMongo 3.12+ 开始强制要求连接时发送客户端元数据，部分老旧代理（如某些 HAProxy 配置）会丢弃该字段，导致服务端无响应；此时需升级代理或改用直连
最容易被忽略的是：错误日志里出现 ServerSelectionTimeoutError 时，90% 的情况其实根本没发出去任何 TCP 包——所以抓包看 tcpdump -i lo port 27017 比读堆栈更有用。
