必须加 showPrivileges: true 才能导出完整权限细节,否则角色为空壳;需用 db.createRole() 脚本导入,mongorestore 无法处理 system.roles;依赖角色须按顺序创建,迁移后须逐字段验证权限一致性。

db.getRoles() 导出角色时必须加 showPrivileges: true
直接调用 db.getRoles({}) 只返回角色名和基本描述,不包含权限细节(如资源范围、动作列表),迁移后角色无法生效。必须显式传入 showPrivileges: true,否则导入脚本创建的角色是空壳。
实操建议:
- 连接源集群的
admin库执行:mongosh "mongodb://user:pass@source:27017/admin?authSource=admin" \ --eval 'JSON.stringify(db.getRoles({ includeBothBuiltinAndCustom: true, showPrivileges: true }), null, 2)' \ > roles_dump.json -
includeBothBuiltinAndCustom: true确保内置角色(如readAnyDatabase)和自定义角色一并导出 - 输出是纯 JSON,不是 BSON,不能被
mongorestore直接消费
导入角色要用 db.createRole() 脚本,不是 mongorestore
mongorestore 只能还原集合数据,而角色元信息存储在系统集合 system.roles 中,该集合受 MongoDB 4.2+ 安全策略保护,mongodump 和 mongorestore 均无法访问——哪怕你用 admin 用户登录并显式指定库和集合,也会静默跳过。
实操建议:
- 用
jq将roles_dump.json转为可执行脚本:cat roles_dump.json | jq -r '.[] | "db.createRole(\(. | tojson));"' > create_roles.js
- 运行脚本前确保目标环境已存在所有涉及的数据库(例如角色中含
{"role":"read","db":"appdb"},则appdb必须已存在,否则报错) - 若目标已有同名角色,
createRole()会失败,需先db.dropRole("rolename")
自定义角色依赖的其他角色必须提前存在
MongoDB 角色支持继承,比如 myAppReader 继承自 read 和 customMetricsViewer。如果 customMetricsViewer 是另一个自定义角色,它必须在 myAppReader 创建前就已存在,否则 createRole() 报 RoleNotFound 错误。
实操建议:
- 导出时按依赖顺序排序:先导出无依赖的角色(如只继承内置角色的),再导出依赖其他自定义角色的
- 手动检查
roles_dump.json中每个角色的roles字段,识别依赖链 - 生成脚本时,把无依赖角色的
createRole()语句放在前面,避免执行中断
迁移后验证角色是否真正可用
导出 JSON 成功、脚本执行无报错,不代表角色已生效。常见漏点:权限作用域(resource)里的数据库名拼写错误、集合名大小写不一致、通配符使用不当(如 "collection": "" 不等于 "collection": "*")。
验证要点:
- 用目标用户连接,执行
db.runCommand({connectionStatus: 1}).authInfo.authenticatedUsers,确认用户已认证且角色列表完整 - 实际执行一条受限操作,例如对某集合
find(),看是否因权限不足被拒绝 - 检查
db.getRole("rolename", { showPrivileges: true })返回结果,比对源环境输出,逐字段确认一致性
最易忽略的是角色里 db 字段值与目标环境实际数据库名不一致——比如导出时是 "db": "prod_app",但目标库名叫 "app_v2",这种错位不会报错,但权限完全失效。


















