为何Heroku可连接MongoDB Atlas但本地环境连接失败

按以下顺序逐一排查即可解决：

• 优先检查本地环境变量配置
  Heroku上的dbLink是存在平台环境变量配置里的，本地运行不会自动读取线上配置。你需要先在项目根目录创建.env文件，写入和线上完全一致的数据库连接串，格式为dbLink=你的完整mongodb连接串；同时确认本地已安装dotenv依赖，且在项目入口文件（通常是server.js/app.js）最顶部添加了require('dotenv').config()，否则本地读取不到process.env.dbLink的值，会直接触发连接错误。
• 核查IP白名单实际匹配情况
  不要默认自己加的IP一定正确：
  1. 本地如果开了VPN、网络代理、游戏加速器先全部关闭，这类工具会修改网络出口IP，和你手动查询的本机IP不一致，会直接被白名单拦截。
  2. 可以先在Atlas白名单配置中临时添加0.0.0.0/0（允许所有IP访问，仅用于本地调试，正式环境不要保留该配置），如果此时能正常连接，说明之前添加的本地IP确实有误，重新查询当前网络的出口IP替换白名单条目即可。
• 校验连接串正确性
  直接从Atlas控制台重新复制最新的标准连接串，注意两个细节：
  1. 连接串里的<password>占位符要替换成数据库访问账号对应的密码，不是你登录Atlas控制台的账号密码。
  2. 如果密码包含@、:、/这类特殊字符，必须做URL编码，否则连接串解析失败也会报服务器选择错误。
• 排查本地网络与依赖问题
  1. 临时关闭本地防火墙、杀毒软件测试，部分安全软件会拦截Node.js的未知出站请求。
  2. 如果使用公司、校园网络，先换手机热点测试，这类内网通常会封禁MongoDB服务默认的27017端口，导致连接被拦截。
  3. 把本地Mongoose升级到最新稳定版，驱动版本和Atlas集群版本不兼容也会触发连接失败，升级命令为npm install mongoose@latest。
  4. 如果出现DNS解析相关报错，可以把本地网络DNS修改为公共DNS（如114.114.114.114），部分运营商DNS无法正常解析Atlas的集群地址。

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