db.changeuserpassword()适用于仅修改当前认证数据库中已登录用户的密码且不调整角色等配置的场景；必须先use目标库（如admin），连接串需指定authsource，密码含特殊字符须url编码，否则解析失败。
不能完全“不中断”——改密码本身会断开旧连接，但可以控制影响范围、避免权限丢失、防止应用雪崩。关键不在“不断开”，而在“断得准、恢复快、不丢权”。
db.changeUserPassword() 适合什么场景？
只改密码、不碰角色、用户建在当前数据库里，且你已用该用户登录成功。它本质是 db.updateUser() 的快捷封装，省事但没容错空间。
- 执行前必须
use admin（改 admin 用户）或use mydb（改 mydb 库里的用户），否则改的是默认库（如 test）里的同名用户 - 连接串里必须带
authSource=admin或启动时加--authenticationDatabase=admin，否则驱动不知道去哪验身份 - 密码含
@、/、:等字符，必须 URL 编码，否则mongosh报InvalidConnectionString - Node.js 驱动等连接池不会自动重连，旧连接持续报
Authentication failed直到超时或手动client.close()
db.updateUser() 怎么避免清空 roles？
它不是“更新字段”，而是“全量替换文档”。漏传 roles、mechanisms 或 authenticationRestrictions，这些配置就没了——用户立刻失权。
- 先运行
db.getUser("username")，复制输出里的roles、mechanisms、authenticationRestrictions字段值 - 构造 update 对象时，必须显式写出全部字段：
db.updateUser("username", { pwd: "newpass", roles: [/* 原数组 */], mechanisms: ["SCRAM-SHA-256"] }) - 用
passwordPrompt()代替明文密码，避免命令历史泄露：pwd: passwordPrompt() - Atlas 环境下该命令直接被拦截，报
Command updateUser not supported，只能走控制台或 API
改完密码连不上？90% 是认证库没对齐
不是密码错了，是客户端没告诉驱动“去哪个库查这个用户”。尤其 Python 的 pymongo 和 Node.js 的 mongodb 驱动，默认不推断 authSource。
- 连接字符串必须显式指定：
mongodb://user:pass@host:27017/mydb?authSource=admin - 代码里初始化 client 时，要传
authSource参数：Node.js 中是{ authSource: "admin" }，Python 中是authSource="admin" - replica set 环境下，主节点写入后从节点同步有延迟，刚改完立刻切到 secondary 连，可能因缓存仍认旧密码，建议等几秒再测
- 测试新密码时，用新开的
mongosh连接：mongosh "mongodb://admin:newpass@localhost:27017/admin?authMechanism=SCRAM-SHA-256"
生产环境最易忽略的三个点
改完密码后服务跑着，但安全隐患已经埋下：一是连接池里残留的旧连接还在报错，二是驱动没配 authSource 导致部分请求静默失败，三是忘记验证 roles 是否真保留下来——这三个问题都不会立刻炸，但会在半夜告警里突然爆发。
