为何本地Robo3T可连接远程MongoDB，Node.js却报IP白名单错误

• 首先检查连接字符串协议：MongoDB Atlas 副本集/Serverless 集群默认推荐使用 mongodb+srv:// 协议，该协议会自动拉取集群的副本集配置、认证源等参数。Robo3T 图形界面可能自动适配了协议，而代码中硬编码为 mongodb:// 时需要手动补充大量额外参数才可以正常连接，优先替换为 srv 协议测试。
• 补充缺失的连接参数：如果必须使用普通 mongodb:// 协议，需要在 mongoose 连接参数中补充 authSource: "admin"（Atlas 默认用户认证库为 admin），以及你的集群对应的 replicaSet 参数，否则 Mongoose 无法正确识别集群节点。
• 检查用户名密码的特殊字符转义：如果连接字符串中的用户名/密码包含 @、:、/、? 等URL特殊字符，需要先做URL编码后再拼接到连接串中。Robo3T 图形化输入时会自动完成转义，而直接拼接环境变量不会自动处理转义，会导致连接串解析错误，触发通用报错。
• 验证驱动版本兼容性：检查本地安装的 mongoose 以及依赖的 mongodb 驱动版本是否和 Atlas 集群版本兼容，过老的驱动不支持新版 MongoDB 集群的通信协议会导致连接失败。你可以单独用原生 mongodb 驱动做连接测试，排除 Mongoose 封装导致的问题。
• 开启调试日志获取真实报错：在 mongoose.connect 前添加代码 mongoose.set('debug', true)，同时在连接参数中增加 serverSelectionTimeoutMS: 30000 延长服务器选择超时时间，获取底层的真实报错信息，官方返回的通用白名单提示很多时候会掩盖真实的认证、配置错误。
• 排查本地网络策略限制：测试 Node.js 运行环境是否可以正常访问 Atlas 集群的端口，可以执行命令 curl -v telnet://<你的集群地址>:27017 验证连通性。确认 Node.js 环境是否配置了和 Robo3T 不一致的代理、防火墙规则，导致网络请求被拦截。

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