MongoDB 4.0+ 中 db.copyDatabase() 因底层依赖 copydb 命令及 copydbgetnonce 协议被彻底移除而必然失败，不支持 SCRAM-SHA-256 认证机制；推荐使用 mongodump + mongorestore（需显式指定 --authenticationDatabase）替代，并注意副本集克隆时 oplogSize、keyFile、用户角色和 dbPath 清理四要素。
在 MongoDB 4.0+ 启用认证的环境下，db.copyDatabase() 已不可用——它不支持 SCRAM-SHA-256（4.0 默认机制），且早在 4.0 就彻底移除了对 MONGODB-CR 的兼容。直接调用会报错：command copydb not found 或 Authentication failed，不是密码错，而是协议层被拒绝。
为什么 db.copyDatabase() 在认证集群里必然失败
该命令底层依赖已废弃的 copydb 命令和 copydbgetnonce 协议握手，在 4.0+ 中全量移除。即使你降级到 3.6 并启用 MONGODB-CR，只要服务端强制要求 SCRAM（如启用了 security.authorization: enabled + setParameter: {enableLocalhostAuthBypass: false}），它仍会因机制不匹配而中断。
-
db.copyDatabase("src", "dst", "host:27017", "u", "p", "SCRAM-SHA-1")—— 在 4.0+ 上语法合法但运行时静默失败或返回空响应 - 错误日志中常见：
Failed to authenticate with remote server: AuthenticationFailed: SCRAM-SHA-1 authentication failed，实际是驱动尝试降级失败 - 它无法穿透副本集的 readPreference 设置，强制走 primary，且不支持 TLS 加密通道透传凭据
替代方案：mongodump + mongorestore（带 auth 参数）
这是目前最稳定、可审计、支持 TLS 和完整权限控制的克隆方式。关键不是“能不能用”，而是参数必须显式指定认证上下文。
- 源库导出：
mongodump --host "192.168.14.52:27017" --username "backupUser" --password "pwd" --authenticationDatabase "admin" --db "myapp" --out "/backup/myapp" - 目标库导入：
mongorestore --host "localhost:27017" --username "admin" --password "pwd" --authenticationDatabase "admin" --drop "/backup/myapp/myapp" - 必须加
--authenticationDatabase，否则默认去test库找用户，而 root 用户只存在于admin - 若目标库已有同名数据库且需覆盖，
--drop不可省；若只想追加集合，去掉该参数但注意索引/唯一键冲突
跨副本集克隆时最容易漏掉的三件事
即便 mongodump/mongorestore 跑通，副本集环境下的克隆仍可能让数据“看起来正常但实际不可用”。
- 目标节点未清空
dbPath：残留的local.oplog.rs或local.system.replset会导致新节点拒绝加入，报错Our replica set ID differs from the one in the config - keyFile 权限不对：所有节点（含新克隆节点）的
/mongo/mongo.keyfile必须是chmod 400，600或644都会启动失败，错误信息明确提示permissions on ... are too open - 没在主节点创建同步所需的用户：
mongorestore本身不复制用户，但后续初始同步（initial sync）需要clusterManager或root角色才能读取 oplog，必须提前在主节点admin库执行db.createUser({user:"rsSync", pwd:"...", roles:[{role:"root", db:"admin"}]})
Studio 3T 等 GUI 工具的隐藏风险
它封装了 mongodump/mongorestore，但默认不暴露 --authenticationDatabase 字段。界面里填的用户名密码，常被错误地送到 test 库验证，导致连接成功但 dump 失败。
- 在 Studio 3T 中，右键数据库 → “Copy Database…” → 点击齿轮图标 → 显式勾选 “Use admin database for authentication”
- 如果目标是副本集，务必关闭 “Use replica set connection string” 选项，改用手动输入 primary 地址，避免工具自动连 secondary 导致
not master错误 - 它不会帮你处理 keyFile 或 oplogSize，这些仍需人工配置文件并重启
mongod
真正卡住人的从来不是命令记不住，而是以为“导出再导入”就结束了——副本集克隆本质是重建一个具备相同身份、权限、同步能力的新节点，而不是搬运一堆 BSON 文件。oplogSize、keyFile、用户角色、dbPath 清理，四个点缺一不可，任意一个遗漏都会让节点停在 STARTUP2 状态再也进不了 SECONDARY。
