使用Mongoose 8.9.2连接MongoDB Atlas遇querySrv EBADNAME错误求助

问题背景 #

使用Node.js 22.12.0 + Express 4.21.2 + Mongoose 8.9.2连接MongoDB Atlas时，持续出现DNS解析错误，错误信息如下：

Error connecting to database! Closing Connection!!
ERROR ===> Error: querySrv EBADNAME _mongodb._tcp.3!

错误栈：

Error: querySrv EBADNAME _mongodb._tcp.3!
at QueryReqWrap.onresolve [as oncomplete] (node:internal/dns/promises:293:17)

已尝试操作：允许所有IP访问Atlas集群、切换网络提供商、修改DNS为谷歌地址，但问题未解决。

使用的MongoDB URI格式 #

mongodb+srv://<db_admin>:<db_password>@maincluster.expmq.mongodb.net/<db_name>?retryWrites=true&w=majority&appName=MainCluster

应用代码 #

require('dotenv').config();
const express = require('express');
const mongoose = require('mongoose');

const app = express();

const port = 3000;

const DB = process.env.DB_URI
    .replace('<db_admin>', process.env.DB_ADMIN_USERNAME)
    .replace('<db_password>', process.env.DB_ADMIN_PASSWORD)
    .replace('<db_name>', process.env.DB_NAME);

const connectDB = async () => {
    try {
        await mongoose.connect(DB);
        console.log('Database connected successfully');
    } catch(err) {
        console.error(`Error connecting to database! Closing Connection!!`);
        console.error(`ERROR ===> ${err}`);
        mongoose.connection.close();
        process.exit(1);
    }
}

connectDB();

app.get('/', (req, res) => {
    res.send(`Backend running`);
});

app.listen(process.env.PORT || port, () => {
    console.log(`Server running on port ${port}`);
});

解决步骤 #

1. 修复URI占位符替换逻辑 #

如果数据库密码或用户名包含特殊字符（如@、$、/等），直接替换会破坏URI结构，导致DNS解析异常。需要对敏感字段进行URL编码：

const DB = process.env.DB_URI
    .replace('<db_admin>', encodeURIComponent(process.env.DB_ADMIN_USERNAME))
    .replace('<db_password>', encodeURIComponent(process.env.DB_ADMIN_PASSWORD))
    .replace('<db_name>', process.env.DB_NAME);

同时打印生成的DB变量，确认集群地址部分为maincluster.expmq.mongodb.net，无3!这类异常字符。

2. 切换到标准TCP连接URI #

绕开SRV记录的DNS解析问题，直接使用MongoDB Atlas提供的非SRV格式连接字符串：

• 登录Atlas控制台，进入目标集群的「连接」页面
• 选择「连接你的应用」，驱动选「Node.js」，版本选「4.0或更高」
• 复制不带+srv的URI，替换占位符后使用，示例格式：

mongodb://<db_admin>:<db_password>@maincluster-shard-00-00.expmq.mongodb.net:27017,maincluster-shard-00-01.expmq.mongodb.net:27017,maincluster-shard-00-02.expmq.mongodb.net:27017/<db_name>?ssl=true&replicaSet=MainCluster-shard-0&authSource=admin&retryWrites=true&w=majority&appName=MainCluster

3. 验证环境变量完整性 #

• 检查.env文件中DB_URI是否完整复制，无字符遗漏或截断
• 确认DB_ADMIN_PASSWORD等变量未因特殊字符导致读取不完整（比如密码中的#会被视为注释，需用引号包裹）

4. 强制指定DNS服务器 #

在代码开头添加DNS配置，强制使用谷歌DNS解析：

const dns = require('dns');
dns.setServers(['8.8.8.8', '8.8.4.4']);

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