不能用 admin 用户直连业务库,因其违反最小权限原则,默认拥有 listDatabases、dropDatabase 等高危权限,一旦应用被注入或配置泄露,风险升至实例级;Spring Boot 应用仅需对业务库读写,应创建限定在目标库的专用账号,并显式指定 authSource=admin 与 URL 编码密码。

为什么不能用 admin 用户直连业务库
用 admin 账号连业务库(比如 myapp)看似简单,但会绕过最小权限原则:它默认能执行 listDatabases、dropDatabase 等高危命令,一旦应用被注入或配置泄露,风险直接升级到实例级。Spring Boot 应用只需对目标库读写,不需要管理权限。
创建账号时必须指定 authSource 和角色范围
在 admin 库中执行 db.createUser() 时,roles 字段必须精确限定到业务库,且不能混用跨库角色。常见错误是只写 { role: "readWrite", db: "myapp" } 却忘了切换到 admin 库上下文,导致用户实际建在了 test 库下,后续连接失败。
- 先运行
use admin,再执行创建语句 - 角色必须显式绑定到业务库,例如
{ role: "readWrite", db: "myapp" },不要用root或dbAdminAnyDatabase - 如果应用只读,用
read角色;若需聚合或索引操作,才额外加clusterMonitor等受限角色
Spring Boot 的 uri 必须带 authSource=admin 且密码 URL 编码
spring.data.mongodb.uri 是唯一可靠的方式,其他字段如 username/password 在 Spring Boot 2.4+ 已废弃。漏掉 authSource=admin 会导致认证凭据被送到业务库(如 myapp)去查,而用户实际存在 admin 库里,报 MongoSecurityException。
- 正确格式:
mongodb://myappuser:my%40pass@localhost:27017/myapp?authSource=admin&authMechanism=SCRAM-SHA-256 - 密码含
@、/、:必须 URL 编码,否则 URI 解析截断——pa@ss/word→pa%40ss%2Fword - 生产环境 MongoDB 4.0+ 默认要求
SCRAM-SHA-256,不显式声明会 fallback 到 SHA-1,认证失败
验证权限是否真的最小化
建完账号别急着上线,用该账号连上后手动测试边界操作。最容易被忽略的是「隐式依赖」:比如应用用了 @Document 自动建索引,但账号没 createIndex 权限,启动就卡住;或者分页查询用了 $facet,却没授 allowDiskUse 权限。
- 用
mongosh以新账号登录,执行db.runCommand({connectionStatus: 1})确认认证成功 - 尝试
db.myapp.insertOne({x:1})和db.getSiblingDB("admin").listDatabases()—— 后者应报not authorized - 检查应用日志是否出现
Unauthorized或command not allowed类错误,对应补授权而非扩权


















