PyMongo连接MongoDB Atlas报ServerSelectionTimeoutError问题

这个WinError 10054 远程主机强制关闭现有连接报错和你创建集群的操作无关，前3-4次连接正常已经排除了IP白名单未配置、账号密码错误、驱动缺失这类基础问题。核心诱因是两个：一是MongoDB Atlas默认会回收闲置超过10分钟的空闲连接，二是PyMongo 4.x默认配置在Windows环境下无法及时感知连接已被远端断开，复用失效的死连接时就会抛出这个超时错误，部分场景下本地代理、防火墙截断长连接也会触发同类问题。

• 显式补全连接串参数，对齐Atlas的连接回收规则
  不要用Atlas控制台给的默认连接串，手动添加连接池、心跳、超时相关参数，让客户端主动淘汰失效连接，替换后的连接代码如下：

  import pymongo
  # 把<your-password>替换成你的真实数据库密码，不要保留方括号
  conn_uri = "mongodb+srv://ManbirJudge:<your-password>@cluster0.jlotl6y.mongodb.net/?retryWrites=true&w=majority&connectTimeoutMS=5000&socketTimeoutMS=30000&maxIdleTimeMS=600000&heartbeatFrequencyMS=30000"
  client = pymongo.MongoClient(conn_uri)
  # 连接验证
  client.server_info()
  

  核心参数作用：maxIdleTimeMS=600000和Atlas端10分钟的空闲连接回收时间对齐，客户端会自动丢弃闲置超期的连接，不会复用已经被远端关闭的死连接；heartbeatFrequencyMS=30000将集群节点状态检测间隔缩短为30秒，能及时感知副本集节点切换、网络波动等状态变化。
• 排查本地网络拦截规则
  Windows环境下开启的系统代理、VPN、第三方防火墙、企业网络安全策略，都会静默截断和Atlas 27017端口的长连接，尤其是空闲状态的长连接很容易被安全设备判定为无效连接掐断。临时关闭所有代理、防火墙后测试，如果恢复正常，把*.mongodb.net域名的27017端口出站规则加入白名单即可。
• 修正MongoClient的使用逻辑
  整个应用生命周期内只初始化一次MongoClient实例即可，PyMongo自带的连接池会自动维护连接健康状态，不需要每次操作数据库都新建实例，也不要在短时间内反复初始化客户端打满连接数触发Atlas的限流。如果是在Django项目中使用，把客户端初始化逻辑放到项目启动配置文件中，不要写在视图函数、接口处理逻辑里重复执行。
• 修复驱动版本bug
  PyMongo 4.1.1存在已知的SRV域名解析缓存bug，Windows环境下长时间运行后会缓存过期的节点IP，直接升级驱动到最新稳定版即可修复：

  pip install --upgrade pymongo dnspython
  

• 本地开发调试场景下，直接换用本地MongoDB是完全可行的，能彻底规避公网连接、网络策略带来的各类连接问题，开发效率更高。
• 生产部署场景下不建议直接放弃MongoDB Atlas，上述配置调整完成后可以解决绝大多数同类连接报错。如果确实不想用Atlas，优先选择和部署机房同区域的云厂商托管MongoDB服务，比自行搭建本地实例的维护成本低很多。

内容的提问来源于stack exchange，提问作者Manbir Judge