MongoDB远程连接失败原因：检查防火墙端口与bindIp设置

远程连接 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 拦截，又被防火墙或安全组阻断在半路，最后还因认证参数缺失而被静默拒绝。这三个因素缺一不可，排查顺序也需按部就班——先确保端口通畅，再确认服务监听，最后通过认证校验，每一步都不能省略。