远程连接 MongoDB 失败，绝大多数情况源于 bindIp 配置有误或系统防火墙封堵了端口，并非密码错误或驱动版本不兼容导致。
为什么无法连接？先检查 bindIp 是否仅绑定 127.0.0.1
MongoDB 默认启动时，仅监听本地回环地址（即仅允许本机访问）。这意味着外部一切连接请求都会被拒绝——即便网络通畅、密码无误、防火墙已放行，客户端依然会收到 ECONNREFUSED 报错。排查方法十分简单：执行 grep bindIp /etc/mongod.conf（Linux 环境），或直接打开配置文件，找到 net.bindIp 字段进行核实。
- 若该字段值为
127.0.0.1或为空，必须修改：将其设为0.0.0.0（允许所有 IPv4 地址访问），或明确列出服务器的公网/内网 IP，例如192.168.1.100,127.0.0.1 - 修改完成后必须重启服务：执行
sudo systemctl restart mongod，仅重载配置无效 - 注意：若设置为
0.0.0.0，务必搭配认证机制与防火墙白名单，否则数据将暴露在公网风险中
telnet 或 nc 无法连通端口？优先排查防火墙与安全组
遇到 MongoServerSelectionError: connect ECONNREFUSED 错误时，不要急于修改代码。首要任务是确认目标端口是否真正可达。MongoDB 默认端口为 27017，但云数据库（例如 Atlas、阿里云 MongoDB）常使用非默认端口（如 3717、8635），务必根据实际配置填写。
- 本地测试网络连通性：执行
telnet your-mongodb-host 27017，若连接失败则说明网络层已被阻断 - 在服务器本地查看端口监听状态：执行
ss -tuln | grep :27017，若无输出则表明 MongoDB 未在监听，或bindIp配置有错误 - 云服务器（例如阿里云、腾讯云）必须检查安全组规则：入方向需放行对应端口，来源 IP 建议限定为你的客户端 IP 或 IP 段，避免直接设置
0.0.0.0/0 - 物理服务器或宝塔面板环境，还需检查系统防火墙：执行
sudo ufw status或sudo firewall-cmd --list-ports，确保27017在允许列表中
连接字符串中 authSource 与 authMechanism 未正确设置，同样会导致静默失败
即便 bindIp 和防火墙配置均正确，连接仍可能在认证阶段卡住。错误信息往往较为模糊——比如仅提示 timeout 或 connection closed，尤其在通过 URI 连接时。真正原因通常在于缺失关键认证参数。
- 如果用户是在
admin数据库中创建的，连接字符串必须显式指定authSource=admin，例如：mongodb://user:pass@host:27017/mydb?authSource=admin - 旧版 MongoDB（使用 SCRAM-SHA-1 认证）与新版本（≥4.0，默认倾向
SCRAM-SHA-256）需要保持匹配。Node.js 驱动若未添加authMechanism=SCRAM-SHA-256参数，可能导致握手失败 - 密码中包含特殊字符（如
@、/、:）时，必须进行 URL 编码，否则解析 URI 会出错——例如pass@123应写为pass%40123
实际上，最常卡住远程连接的地方，并非驱动代码写错，而是 mongod 进程本身未准备好接收外部请求：它被 bindIp 拦截，又被防火墙或安全组阻断在半路，最后还因认证参数缺失而被静默拒绝。这三个因素缺一不可，排查顺序也需按部就班——先确保端口通畅，再确认服务监听，最后通过认证校验，每一步都不能省略。
