Heroku部署应用时连接Mongo Atlas报MongoParseError无主机域名TLD错误

问题现状 #

• 应用本地运行时，MongoDB数据库连接功能完全正常
• 部署至Heroku平台后连接失败，报错为：MongoParseError: URI does not have hostname, domain name and tld
• 已在Mongo Atlas控制台完成IP访问白名单配置，允许任意IP地址接入
• 当前项目中使用的数据库连接逻辑如下：

mongoose.connect(`mongodb+srv://drdung1999:onichan123@cluster0.lbxxt.mongodb.net/pinet2?retryWrites=true&w=majority`, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
  useFindAndModify: false
});
// 绑定数据库连接状态监听事件
const db = mongoose.connection;
db.on('error', console.error.bind(console, 'connection error:'));
db.once('open', function() {
  console.log('Connect mongDB success');
});

问题排查与修复步骤 #

• 核查依赖版本兼容性：mongodb+srv格式的连接串解析能力需要Mongoose 5.7.0以上版本支持，如果Heroku部署时拉取到低版本的Mongoose依赖，会无法正确识别连接串的srv结构，直接触发域名解析类报错。可在项目package.json中锁定Mongoose的稳定新版本，避免部署时自动安装不兼容的旧版本。
• 检查连接串的完整性与转义规则：如果MongoDB账号密码中包含与URI格式冲突的特殊字符（如@、:、/等），未做URL编码会导致解析器提前截断连接串，将原本属于域名的内容错误识别为账号密码部分，最终判定无有效域名可解析。
• 避免硬编码数据库连接串：将完整的MongoDB连接串配置为Heroku平台的环境变量，在代码中通过process.env.MONGO_URI方式读取，避免平台安全扫描机制对硬编码敏感信息的截断、修改，导致连接串内容残缺。
• 排查平台DNS解析限制：Heroku部分运行环境的默认DNS配置可能无法解析MongoDB Atlas的SRV记录，可尝试替换连接串为标准长格式的mongodb连接地址，绕开srv记录的解析流程完成连接。

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