GoDaddy共享主机cPanel连接Mongo Atlas失败求助（ECONNREFUSED）

我之前在GoDaddy共享主机上遇到过几乎一模一样的问题，折腾了好一阵才搞定，给你几个关键的排查方向和实操方案：

• 先排查端口限制问题
  GoDaddy共享主机默认会封禁大部分对外出站端口，Mongo Atlas常规连接用的27017端口大概率是被封了。你可以改用Mongo Atlas的SRV连接字符串——这种方式走的是443端口（HTTPS端口，共享主机基本不会封）。只需要把你的连接字符串改成带srv前缀的格式，比如：

  const uri = "mongodb+srv://<username>:<password>@cluster0.mongodb.net/<dbname>?retryWrites=true&w=majority";
  

  Node.js的Mongo驱动完全支持这种格式，本地能跑的代码改个连接字符串就能用。

• 确认真实出站IP是否加入白名单
  GoDaddy共享主机的出站IP和cPanel后台显示的服务器IP可能不一致（尤其是用了NAT代理的情况）。你可以在cPanel终端里运行以下命令获取真实的对外IP：

  curl ifconfig.me
  

  把这个IP加到Mongo Atlas的白名单里，别只加cPanel显示的服务器IP——我之前就是踩了这个坑，白名单加错了IP折腾了半天。

• 检查Node.js版本与Mongo驱动的兼容性
  本地的Node版本和GoDaddy主机上的版本可能差异很大，比如你本地用Node 18，主机却默认是Node 14，而新版Mongo驱动可能不兼容旧Node版本。你可以在终端里运行node -v查看主机的Node版本，然后：

  • 要么在cPanel的「Node.js管理器」里切换到和本地一致的版本；
  • 要么降级Mongo驱动到兼容的版本，比如针对Node 14可以安装mongodb@4.11.0：

    npm install mongodb@4.11.0
    

• 测试主机到Atlas的连通性
  在cPanel终端里用以下命令测试端口是否能通：

  nc -zv cluster0-shard-00-00.mongodb.net 27017
  

  如果显示连接失败，那肯定是端口被封了，直接用SRV连接字符串就行；如果能通，那就要检查连接字符串里的用户名、密码是否正确——尤其是密码里有特殊字符（比如@、#）的话，要进行URL编码（@转成%40，#转成%23）。

• 添加详细日志排查隐藏问题
  可以在代码里开启Mongo驱动的调试模式，打印更详细的连接日志：

  const mongoose = require('mongoose'); // 如果用mongoose的话
  mongoose.set('debug', true);
  
  mongoose.connect(process.env.MONGODB_URI)
    .then(() => console.log('数据库连接成功'))
    .catch(err => console.error('连接失败详情:', err));
  

  运行代码后看终端输出，有时候会发现是DNS解析失败之类的隐藏问题，这种情况可以尝试把Atlas的域名换成对应IP（不过不推荐长期用，因为Atlas的IP可能会变）临时测试。

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