如何修复Python连接MongoDB时ServerSelectionTimeout错误？-MongoDB-PHP中文网

ServerSelectionTimeoutError本质是PyMongo无法连接任何可用MongoDB节点，需先确认服务运行状态、网络连通性、bindIp配置、连接字符串格式及版本兼容性，再排查副本集参数、DNS解析、防火墙或容器网络问题。

如何修复python连接mongodb时serverselectiontimeout错误？

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 却被防火墙拦截

单机、副本集、分片集群的连接方式差异极大，写错一个参数就会触发 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 是调试友好，但生产环境不要盲目调大——它掩盖的是根本连不通的问题

PyMongo 默认启用 SRV 记录解析，且对 hostname 敏感。localhost 在容器内可能不指向宿主机，DNS 缓存也可能导致旧 IP 生效。

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

把连接字符串里的 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 4.0+ 默认使用 MongoDB 5.0+ 的协议特性，老版本服务端可能拒绝协商，静默表现为连接超时。

运行 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 比读堆栈更有用。