PyMongo 连不上 localhost:27017 是因 sshtunnel 默认监听 127.0.0.1 而非 localhost，且启动异步需显式等待；应改用 127.0.0.1 连接、验证隧道激活、探测端口就绪、设置 keepalive 与超时，并确保私钥权限为 600。
sshtunnel 启动后 PyMongo 连不上 localhost:27017？
不是 MongoDB 没启动，而是 sshtunnel 默认不绑定到 localhost，它监听的是 127.0.0.1 —— 而某些系统（尤其是 macOS 或 Docker 环境）下，localhost 和 127.0.0.1 的 DNS 解析或网络栈行为可能不一致，导致 PyMongo 连接超时。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- PyMongo 连接字符串里明确写
127.0.0.1，别用localhost：mongodb://127.0.0.1:27017/mydb - 创建
SSHTunnelForwarder时，显式指定remote_bind_address=('your-mongo-host', 27017)，不要依赖默认值 - 确认 SSH 隧道真正建立成功：检查
tunnel.local_bind_port是否非零，且tunnel.is_active为True
PyMongo 连接卡住或抛出 ConnectionRefusedError
常见于隧道未就绪就急着连 MongoDB —— sshtunnel 是异步启动的，start() 返回后，底层 TCP 连接未必已打通。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 启动隧道后，加一层简单等待和探测：
import socket; sock = socket.socket(); sock.connect(('127.0.0.1', tunnel.local_bind_port)); sock.close() - 避免在
try/finally外直接调用client.list_database_names()，先用client.admin.command('ping')快速验证连通性 - 如果远程 MongoDB 绑定在
127.0.0.1（而非0.0.0.0），SSH 服务器上无法从外部访问它，此时必须确保remote_bind_address指向该机器上可被 SSH 进程访问的地址（比如'127.0.0.1'）
为什么用 sshtunnel 而不是直接配置 SSH config + local port forward？
Python 脚本里硬编码隧道逻辑，比依赖系统级 ssh -L 更可控：能捕获异常、重试、动态选端口、配合上下文管理器自动关闭。
但要注意几个坑：
-
sshtunnel不支持密码交互式输入，必须提供password或pkey（推荐后者）；私钥路径要绝对，且权限得是600，否则报Paramiko error: Not a valid RSA private key file - 别漏掉
tunnel.stop()—— 尤其在异常退出路径中，否则残留进程会占住本地端口 - 若 MongoDB 开启了认证，认证信息仍传给 PyMongo，
sshtunnel不参与鉴权，只做透明转发
连接成功但查询慢、偶发断连？查 timeout 和 keepalive
SSH 隧道本身容易因网络空闲被中间设备（NAT、防火墙）静默断开，而 PyMongo 默认不会主动探测连接存活。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 给
SSHTunnelForwarder加参数：set_keepalive=30（每 30 秒发一次 SSH keepalive 包） - PyMongo 客户端设置合理 timeout：
serverSelectionTimeoutMS=5000、socketTimeoutMS=30000 - 避免长期复用一个
SSHTunnelForwarder实例 —— 它不是线程安全的，多线程场景下每个线程应有自己的隧道，或改用连接池 + 单隧道 + 全局锁
