必须开启authorization,否则pwdPolicy无效;仅minLength和characterClassCount生效;策略仅校验新建用户或手动改密,不追溯旧用户;客户端驱动可能截断密码导致策略失效。

必须先开启 authorization,否则 pwdPolicy 形同虚设
不启动 --auth 或未在 mongod.conf 中设置 security.authorization: enabled,MongoDB 会静默忽略所有密码策略配置——连日志都不报错,看起来配置生效了,实际完全没用。
正确做法:
- 配置文件里明确写:
security:<br> authorization: enabled
- 启动命令加
--auth(或通过 systemd 配置确保生效) - 改完必须重启
mongod,不支持热加载
真正起作用的只有 minLength 和 characterClassCount
MongoDB 官方文档列了一堆字段,但截至 v7.0,源码里只有 minLength 和 characterClassCount 被实际校验,其余如 maxRepetitions、notUserName、maxConsecutiveCharacters 全是 // TODO: implement 状态,配了也白配。
有效配置示例:
db.adminCommand({<br> setSecuritySettings: {<br> pwdPolicy: {<br> minLength: 10,<br> characterClassCount: 3<br> }<br> }<br>})
说明:
-
minLength: 10:密码至少 10 字符 -
characterClassCount: 3:必须包含大写、小写、数字、特殊字符中任意 3 类 - 特殊字符默认只认
!@#$%^&*()_+-=[]{}|;:,.?,€、中文、空格等不计入
策略只对新用户或手动改密生效,旧用户不会被强制刷新
执行 setSecuritySettings 后,已存在的用户(比如 admin)仍可用弱密码登录,策略不追溯校验。
触发校验的两种场景:
- 新建用户:
db.createUser({ user: "bob", pwd: "123", roles: [] })→ 直接报错"Password does not meet the minimum complexity requirements" - 手动改密:
db.changeUserPassword("bob", "NewPass@2024")→ 此时才走策略校验
注意:没有批量刷新接口,每个旧用户都得单独调一次 changeUserPassword。
客户端驱动可能静默截断密码,导致策略失效
老版本 Node.js 驱动(如 mongodb@3.x)或某些 Java 驱动,在解析连接字符串时,会把 pwd=xxx&xxx 中的 & 当作参数分隔符,导致密码被截断。服务端只对“传过来的那半截”做校验,结果是看似合规,实则极弱。
验证是否被截断:
- 在
mongosh里运行db.runCommand({ connectionStatus: 1 })查当前登录用户名 - 再查
db.getUser("xxx"),比对credentials.scram字段长度是否与原始密码一致
安全做法:永远用 db.auth() 显式认证,别依赖连接串里的 pwd 参数。











