直接重建用户是解决bad auth错误的最快方案，因其常由用户角色、authSource不匹配、密码特殊字符未编码或认证机制不兼容（如SCRAM-SHA-1旧用户）导致，而非单纯密码错误。
OperationFailure 错误不是密码输错了，而是权限配置没对上——直接重建用户比逐条检查更快。
连接时提示 bad auth : authentication failed 怎么办
这个错误表面是认证失败，但大概率不是密码错，而是用户角色或数据库绑定不匹配。MongoDB Atlas 和本地部署的权限模型差异很大，不能套用同一套逻辑。
- 确保连接字符串里
authSource显式指定为admin（Atlas 默认要求，本地部署也建议统一） - 用户必须在
admin数据库中创建，且角色包含userAdminAnyDatabase或对应目标库的readWrite - 如果用的是
mongodb+srv://协议，密码里含@、/、:等字符，必须 URL 编码（例如@→%40） - PyMongo 4.0+ 默认使用
SCRAM-SHA-256认证，旧用户若用SCRAM-SHA-1创建，可能不兼容——删掉重来最省事
本地 MongoDB 启动后连不上，报 not authorized on admin to execute command
这是典型未启用权限验证，或启用了但没先认证就操作。
- 检查
/etc/mongod.conf（Linux）或mongod.cfg（Windows）里是否开启security.authorization: enabled - 修改后必须重启服务：
sudo systemctl restart mongod（Linux）或net stop MongoDB && net start MongoDB（Windows） - 连接后不能直接操作任何库，得先切到
admin并db.auth('username', 'password') - 注意：
db.auth()返回1才算成功，返回0或报错说明凭据无效或用户不在admin库
Atlas 上新建用户后还是连不上
Atlas 控制台里“Database Access”页面看到用户状态是 Active，不代表能立刻连通。- 新建用户后，必须等 1–2 分钟再试，后台策略同步有延迟
- 用户角色选
Atlas admin是过度授权，应选具体数据库的readWrite或read - IP 白名单必须包含你当前出口 IP（不是局域网 IP），临时调试可用
0.0.0.0/0，但上线前务必收窄 - 如果用的是 Python 脚本而非
mongosh，确认没漏掉?retryWrites=true&w=majority这类必需参数
PyMongo 连接池报错说权限不足
maxPoolSize 设太高、minPoolSize 设太低，或者连接复用时没及时释放，都可能触发权限校验异常。
- 不要在每次查询都新建
MongoClient，全局复用一个实例 - 显式设置连接超时：
MongoClient(..., serverSelectionTimeoutMS=5000)，避免卡在无响应节点 - 若用异步（
motor），确保authSource=admin传进 URI，而不是靠默认行为 - 遇到
DuplicateKeyError或ConnectionFailure时，别急着改权限，先看是不是连接串里数据库名写错了（比如把test_db写成testdb）
真正卡住的地方，往往不是权限本身，而是用户创建在哪、认证走哪个库、连接串里哪段被 URL 解码搞乱了——这些细节错一个，bad auth 就稳稳等着你。
