MongoDB连接失败：出现Client network socket disconnected before secure TLS connection was established错误

• 检查网络与端口连通性
  先确认本地到MongoDB主机的网络通路是否正常：

  • 执行命令telnet <MongoDB主机地址> 27017或nc -zv <MongoDB主机地址> 27017测试27017端口是否能连通。如果不通，排查本地防火墙、运营商网络限制，或者MongoDB集群的端口开放配置。
  • 关闭本地代理工具（如VPN、代理软件），代理可能会干扰TLS握手流程导致连接中断。

• 验证连接字符串与TLS配置

  • 确认连接字符串参数正确：MongoDB Atlas的连接字符串默认包含ssl=true，如果是自建集群未开启TLS，需在连接串中添加ssl=false（生产环境不推荐关闭TLS）。
  • 检查连接串中的主机地址、用户名、密码是否正确，密码中的特殊字符（如@、&）需做URL转义。

• 核对MongoDB端TLS设置

  • 若使用MongoDB Atlas，确认客户端支持集群要求的TLS版本（至少TLS 1.2），可在代码中强制指定TLS版本，比如Node.js驱动配置：

    const client = new MongoClient(uri, {
      tlsVersion: 'TLSv1.2',
      tlsAllowInvalidCertificates: false
    });
    

  • 自建集群需检查mongod配置文件的net.tls项，确认证书有效且客户端能正确识别。

• 重新确认白名单与权限

  • 检查白名单中的IP是否为当前机器的公网IP（远程连接场景），部分网络环境下IP会动态变化（如手机热点、宽带拨号），需更新白名单。
  • 确认账号拥有目标数据库的读写权限，权限异常也可能触发连接中断类错误。

• 升级MongoDB驱动版本
  老旧驱动版本可能不兼容新的TLS协议或集群安全规则，尝试将驱动升级到最新稳定版后重试。

内容的提问来源于stack exchange，提问作者Enis Fejzullahu