如何解决Node.js中MongoDB连接串包含@符号报错_对用户名密码进行转义-MongoDB-PHP中文网

必须对用户名和密码分别调用encodeURIComponent()编码，再拼入MongoDB连接字符串；或改用Mongoose的auth选项显式传参，避免URI解析错误。

如何解决node.js中mongodb连接串包含@符号报错_对用户名密码进行转义

连接串里密码含 @，Node.js 直接报错 Connection refused 或 Authentication failed

这不是驱动版本或网络问题，而是 URI 解析器在 @ 处截断了字符串。比如密码是 p@ssword，连接串写成 mongodb://user:p@ssword@localhost:27017/db，解析器会把第一个 @ 当作用户名/密码与 host 的分隔符，导致实际尝试用 user:p 认证，后面全被丢弃。

常见错误现象包括：

MongoServerSelectionError: getaddrinfo ENOTFOUND p（DNS 尝试解析 p 为 host）
MongoParseError: Invalid connection string
Authentication failed（但账号密码明明正确）

必须对 username 和 password 单独做 URI 编码，不能只改连接串

直接在连接串里手写 %40 看似可行，但容易漏掉其他字符（如 :、/、=），且不同语言编码规则不一致。Node.js 驱动本身不自动编码用户输入的 credential，必须由你提前处理。

正确做法是用 encodeURIComponent() 分别编码 username 和 password：

const username = 'admin@prod';
const password = 'p@ss:w0rd/123';
const encodedUsername = encodeURIComponent(username);
const encodedPassword = encodeURIComponent(password);
const uri = `mongodb://${encodedUsername}:${encodedPassword}@localhost:27017/mydb`;

注意：

不要对整个连接串调用 encodeURIComponent()，会破坏协议前缀和结构
不要用 encodeURI()，它不编码 /、: 等关键分隔符
如果用户名或密码为空，encodeURIComponent('') 返回空字符串，没问题

使用 Mongoose 时，绕过 URI 编码的更稳妥方式

Mongoose 支持把认证信息从 URI 中剥离，通过 options 显式传入，彻底避开转义问题：

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

mongoose.connect('mongodb://localhost:27017/mydb', {
  auth: {
    username: 'admin@prod',
    password: 'p@ss:w0rd/123'
  },
  authSource: 'admin' // 指定认证数据库，尤其当用户不在 mydb 中时
});

这种写法的好处：