authsource必须作为url查询参数置于?后，如mongodb://u:p@h:27017/db?authsource=admin；放错位置、遗漏或未url编码特殊字符均导致authentication failed。
authSource 参数加在连接字符串的 query 部分
Node.js 用 mongodb 驱动连接 MongoDB 时，authSource 不是用户名或密码的一部分，也不是数据库路径（/dbname），而是必须作为 URL 查询参数传入。漏掉或放错位置会导致认证失败，错误信息通常是 Authentication failed. 或 failed to authenticate。
正确写法示例：
mongodb://admin:pass@localhost:27017/myapp?authSource=admin
关键点：
-
authSource=admin必须在?后面，和其他 query 参数（如retryWrites=true）用&连接 - 如果 MongoDB 启用了访问控制且用户是在
admin数据库创建的（最常见情况），authSource就得设为admin - 不能写成
mongodb://admin:pass@localhost:27017/admin/myapp—— 路径里的admin是默认数据库名，不是认证源
使用 MongoClient.connect() 时别误用 options.auth
有人看到文档里有 auth 选项，就手动拆用户名密码再配 authSource，结果反而绕过连接字符串解析逻辑，引发兼容问题。新版 mongodb 驱动（v4+）已明确不推荐这种写法。
错误示范：
new MongoClient('mongodb://localhost:27017', {
auth: { username: 'admin', password: 'pass' },
authSource: 'admin' // 这个字段会被忽略！
})
正确做法：把所有认证相关参数都塞进连接字符串，options 里只留连接行为相关的配置（如 maxPoolSize、serverSelectionTimeoutMS）：
const client = new MongoClient(
'mongodb://admin:pass@localhost:27017/myapp?authSource=admin&retryWrites=true',
{ maxPoolSize: 10 }
)
authSource 和实际操作数据库不是一回事
连接字符串里的 myapp（路径部分）是你的「默认数据库」，即不指定 db 名时 client.db() 返回的实例；而 authSource=admin 只管“去哪个库查用户凭证”。两者可以完全不同。
常见场景：
- 用户在
admin库创建：authSource=admin，但业务数据存在myapp库 → 连接串末尾写/myapp?authSource=admin - 用户在
myapp库创建（少见）：authSource=myapp，连接串可简写为/myapp?authSource=myapp或直接/myapp（驱动会默认用路径库作 authSource） - 跨库操作时，
authSource仍只需指定一次，不影响后续client.db('otherdb').collection(...)
环境变量拼接时注意 URL 编码
如果用户名或密码含特殊字符（如 @、/、:），不编码会导致解析错乱，authSource 参数可能被截断或忽略。
例如密码是 pa@ss/word，直接拼：mongodb://u:pa@ss/word@host/db?authSource=admin → 驱动会把 pa@ss 当成 host，报错 getaddrinfo ENOTFOUND pa@ss。
解决方法：
- 用
encodeURIComponent()包裹用户名和密码 - Node.js 中推荐用
mongodb://+url.format()或直接构造合法 URI 字符串 - 或者改用
MongoClient的对象式初始化（但依然要确保authSource在 URI query 中）
最容易被忽略的是：本地测试用简单密码没问题，一上生产换复杂密码就突然连不上 —— 往往就是没做编码，authSource 根本没生效。
