部署应用至服务器时遇MongoDB连接错误，本地运行正常

核心原因 #

报错信息明确指向：托管服务器的公网IP未加入MongoDB Atlas的IP白名单。本地能正常连接是因为你本地设备的IP已在白名单中，但托管服务器使用独立的公网IP，该IP未被Atlas授权访问。

解决步骤 #

• 获取托管服务器公网IP：
  在服务器终端执行以下命令之一，直接获取公网IP：

  curl ifconfig.me
  

  或

  curl ipinfo.io/ip
  

• 将IP添加至Atlas白名单：
  1. 登录MongoDB Atlas控制台，进入目标集群页面
  2. 选择左侧「Network Access」（网络访问）菜单
  3. 点击「Add IP Address」（添加IP地址）
  4. 填入服务器公网IP；若需临时测试或非敏感场景允许所有IP访问，可输入0.0.0.0/0
  5. 保存配置，等待1-2分钟让规则生效
• 额外排查项：
  • 确认部署环境的MongoDB连接字符串与本地完全一致，检查用户名、密码、集群地址是否有误
  • 验证托管服务器防火墙是否允许出站访问27017端口（MongoDB默认端口）
  • 查看Atlas集群状态，确认无维护或异常情况

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