如何解决PyMongo连接时的AuthenticationFailed报错_检查authSource数据库参数-MongoDB-PHP中文网

pymongo连接失败时authsource参数必须显式指定，绝大多数authentication failed错误源于认证源与用户实际所在数据库不一致：用户在admin库创建则需authsource="admin"，在业务库创建则authsource须等于该库名。

如何解决pymongo连接时的authenticationfailed报错_检查authsource数据库参数

PyMongo连接失败时authSource参数必须显式指定

绝大多数OperationFailure: Authentication failed错误，不是密码错了，而是PyMongo默认去哪个库做认证没对上。MongoDB服务端要求用户凭证必须在某个特定数据库下验证，这个库就是authSource——它和你要操作的业务库（比如myapp）可以完全不同。

常见错误现象是：用mongo命令行能连上，Python脚本却报错；或者NoSQLBooster等GUI工具能连，pymongo.MongoClient初始化后一调list_collection_names()就崩。

如果你的用户是在admin库创建的（Atlas默认、自建集群常见），但连接字符串里没写authSource=admin，PyMongo会默认去目标库（如myapp）里找用户，自然找不到
如果用户建在myapp库下，而你又写了authSource=admin，同样失败——认证源和用户所在库不一致
mongodb+srv://协议下，authSource不能通过URL query 参数传（如?authSource=admin），它会被忽略；必须用authSource关键字参数传给MongoClient

正确写法示例：

from pymongo import MongoClient
<h1>✅ 用户在 admin 库中创建</h1><p>client = MongoClient(
"mongodb+srv://user:pass@cluster.mongodb.net/",
authSource="admin"
)</p><h1>✅ 用户在 myapp 库中创建（非admin）</h1><p>client = MongoClient(
"mongodb://user:pass@localhost:27017/myapp",
authSource="myapp"
)</p>

不同部署场景下authSource的取值逻辑

你填什么值，取决于用户账户在哪建的，而不是你想访问哪个库。这个细节被很多人凭直觉猜错。

MongoDB Atlas：所有数据库用户都必须建在admin库，所以authSource固定为"admin"
本地或私有部署的单节点：默认用户建在admin，但你可以用db.createUser({user:"u", pwd:"p", roles:[{role:"readWrite", db:"mydb"}]})在任意库建用户；此时authSource必须等于该用户的db字段值
副本集或分片集群：认证必须走admin库，authSource只能是"admin"，哪怕用户角色只针对某个业务库

查证方式（进mongo shell执行）：

衣来图

一款AI图像与设计工具，主要用于专注于服装领域的AI视觉生成工具，适合需要提升相关任务效率的用户。

下载

// 看当前用户在哪注册的
db.runCommand({connectionStatus: 1}).authInfo.authenticatedUsers
<p>// 或者直接查 admin 库里的用户（需有权限）
use admin
db.system.users.find({user: "your_user"}).pretty()</p>

使用authenticate()方法时也要配对authSource

如果你不用连接字符串带凭据的方式，而是先连再认证（比如要复用连接对象、或动态切用户），那authenticate()调用时也得把authSource带上，否则默认还是去当前db认证。

错误写法：db.authenticate("u", "p") → 默认在db（比如myapp）里找用户
正确写法：client.admin.authenticate("u", "p", authSource="admin") → 明确指定认证源
注意：authenticate()是Database对象的方法，但authSource参数决定它往哪个库发认证请求，所以通常用client.admin.authenticate(...)最稳妥

示例：

client = MongoClient("mongodb://localhost:27017/")
# 先连到 admin 库做认证
client.admin.authenticate("root", "123456", authSource="admin")
# 再取业务库
db = client.myapp
db.collection.count_documents({})  # 这时才真正可用