单机 MongoDB 无法直接升级为副本集，必须通过新增节点并用 --replSet 参数重启原实例后初始化副本集，因原单机缺少 local 数据库与 oplog.rs 集合，直接 convertToReplicaSet 会导致同步失败或状态异常。
单机 MongoDB 无法直接升级为副本集，必须通过「新增节点 + 初始化副本集」完成平滑迁移，过程中业务可读写，但需控制写入节奏和主节点切换时机。
为什么不能直接 convertToReplicaSet？
mongod 启动时若未以 --replSet 参数运行，其数据目录不包含副本集必需的 local 数据库与 oplog.rs 集合。即使后续执行 rs.initiate()，也会因缺少初始 oplog 导致同步失败或状态异常——这不是配置问题，而是数据结构缺失。
常见错误现象包括：no replset config object retrieved、startupStatus: 4、新节点始终卡在 STARTUP2 状态。
- 必须用
--replSet重启原实例（或新建同数据目录的 mongod 进程）才能启用副本集模式 - 首次
rs.initiate()必须由该节点发起，且配置中_id和members[0].host必须严格匹配其实际监听地址 - 如果原单机已长期运行，建议先
db.runCommand({ "setParameter": 1, "enableTestCommands": 1 })并备份local目录（仅用于诊断，不可直接复用）
如何让应用无感切换到副本集？
关键不是“不停机”，而是避免连接中断和写丢失。应用层需支持自动重连与重试，驱动版本不低于 MongoDB 4.2（推荐 6.x+），且连接字符串必须含 replicaSet=xxx 和 readPreference=primary（初期默认即可）。
- 迁移前确认所有客户端使用 DNS 名称（如
mongodb://db1.example.com:27017,db2.example.com:27017/...），而非硬编码 IP - 初始化副本集后，立即添加第二个节点（
rs.add("db2.example.com:27017")），但暂不添加仲裁节点或延迟节点 - 等第二个节点状态变为
SECONDARY且optimeDate落后主节点不超过 5 秒，再执行rs.reconfig()把投票权重设为 1:1，为后续主切做准备 - 不要依赖
rs.stepDown()强制切换——它会触发选举，可能造成短暂不可写；更稳妥的是滚动重启：先停原单机 mongod，再用相同数据目录+--replSet参数重启，最后rs.add()回集群
容易被忽略的兼容性陷阱
看似只是加节点，但版本、存储引擎、featureCompatibilityVersion（FCV）三者不匹配会直接阻断同步。MongoDB 8.0 默认 WiredTiger，且 FCV 必须与目标版本对齐。
- 检查源单机 FCV：
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })；若为 4.4 或更低，迁移前必须先升级 FCV 到目标版本（如 8.0）并等待所有节点生效 - WiredTiger 是唯一支持副本集的存储引擎；若原单机用的是 MMAPv1（已弃用），必须先
mongodump+mongorestore到新 WiredTiger 实例，再建副本集 - 副本集成员间
bind_ip必须互通，且防火墙放行 27017 及内部通信端口（如 27018）；容器环境注意 hostNetwork 或自定义网络策略 - oplog 大小必须足够——单机默认 oplog 是 5% 磁盘空间或 1GB（取小值），副本集建议显式设置
--oplogSizeMB 4096，否则增量同步可能追丢
最易出问题的环节不在初始化，而在第二个节点加入后那几分钟：oplog 同步是否真正追平、应用连接是否悄悄 fallback 到旧地址、监控是否覆盖了 rs.status().members[n].stateStr 和 lastWrite 时间戳。别信“状态是 SECONDARY”就万事大吉——得看它到底同步到了哪条 oplog。
