Python连接MongoDB Atlas时遭遇SSL握手失败问题求助

问题概述 #

使用Python的pymongo库连接MongoDB Atlas集群时，出现SSL握手失败错误，错误信息显示tlsv1 alert internal error，所有分片节点均连接超时。已确认URI正确，仍无法解决。

错误信息 #

Error connecting to MongoDB: SSL handshake failed: ac-efw9wvu-shard-00-02.ubua0y2.mongodb.net:27017: [('SSL routines', '', 'tlsv1 alert internal error')] (configured timeouts: socketTimeoutMS: 20000.0ms, connectTimeoutMS: 20000.0ms),SSL handshake failed: ac-efw9wvu-shard-00-00.ubua0y2.mongodb.net:27017: [('SSL routines', '', 'tlsv1 alert internal error')] (configured timeouts: socketTimeoutMS: 20000.0ms, connectTimeoutMS: 20000.0ms),SSL handshake failed: ac-efw9wvu-shard-00-01.ubua0y2.mongodb.net:27017: [('SSL routines', '', 'tlsv1 alert internal error')] (configured timeouts: socketTimeoutMS: 20000.0ms, connectTimeoutMS: 20000.0ms), Timeout: 30s, Topology Description: <TopologyDescription id: 65e4

代码片段 #

from pymongo import MongoClient, server_api
import certifi

# MongoDB Atlas connection URI
uri = 'mongodb+srv://<username>:<password>@<cluster-address>/?retryWrites=true&w=majority&appName=TaipeiYouBikeHourlyData'

# Use the certifi library to get the path of the CA certificate
ca = certifi.where()

try:
    # Create a MongoClient instance and specify the CA certificate path
    client = MongoClient(uri, server_api=server_api.ServerApi('1'), tlsCAFile=ca)
    
    # Send a ping command to test the connection
    response = client.admin.command('ping')
    print("Successfully connected to MongoDB, response:", response)

except Exception as e:
    print("Error connecting to MongoDB:", e)

排查与解决步骤 #

1. 检查Python和pymongo版本兼容性 #

MongoDB Atlas要求使用支持TLS 1.2+的环境，旧版本依赖库可能存在协议支持问题：

• 确保Python版本≥3.7（推荐3.8+）
• 升级pymongo到最新稳定版：

  pip install --upgrade pymongo
  

• 同步升级dnspython（MongoDB+srv解析依赖）：

  pip install --upgrade dnspython
  

2. 验证CA证书有效性 #

虽然代码中使用了certifi，但证书可能过期或不兼容：

• 更新certifi库：

  pip install --upgrade certifi
  

• 尝试不手动指定tlsCAFile，让pymongo自动调用系统默认证书：
  修改代码，移除tlsCAFile=ca参数：

  client = MongoClient(uri, server_api=server_api.ServerApi('1'))
  

3. 排查网络环境限制 #

• 防火墙/代理：确认本地防火墙、公司代理或VPN未拦截27017端口，或阻断TLS握手。可切换至无代理网络（如手机热点）测试。
• IP白名单：登录MongoDB Atlas控制台，确认当前设备的公网IP已加入集群的IP白名单。
• 地区访问限制：部分地区可能无法直接访问Atlas，尝试使用合规网络环境测试。

4. 强制指定TLS版本 #

手动禁用旧版TLS协议，强制使用TLS 1.2/1.3：

client = MongoClient(
    uri,
    server_api=server_api.ServerApi('1'),
    tlsCAFile=ca,
    tlsDisabledProtocols=['TLS1_0', 'TLS1_1'],
    tlsAllowInvalidCertificates=False
)

5. 检查Atlas集群与用户配置 #

• 登录Atlas控制台，确认集群状态正常（无维护、宕机）。
• 验证数据库用户权限：确保所用账号拥有集群读写权限，密码含特殊字符时需做URL编码（如@替换为%40，:替换为%3A）。
• 核对URI中的集群地址、appName等参数，避免拼写错误。

6. 测试基础网络连通性 #

用nc命令测试节点是否可达：

nc -zv ac-efw9wvu-shard-00-00.ubua0y2.mongodb.net 27017

若连接失败，优先排查网络层面的阻断问题。

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