直接修改配置文件添加replSet参数会导致MongoDB启动失败，因单机数据缺少rs.initiate()生成的副本集元数据；正确流程是先无replication配置启动，再用rs.initiate()初始化，成功后再补配配置文件。
直接改配置文件加 replSet 参数会失败
独立模式下启动的 mongod 进程，如果直接在 mongod.conf 里加上 replication.replSetName: rs0 并重启，MongoDB 会拒绝启动，报错：Cannot start server with both replica set config and no data files in dbpath。这是因为副本集初始化要求所有节点对“初始配置”达成一致，而原单机数据没经过 rs.initiate() 流程，元数据不兼容。
正确做法是先以原配置启动，再通过命令行动态升级：
- 确保
mongod启动时未启用replSet（即配置里没写replication块） - 连接
mongo或mongosh，执行rs.initiate({ _id: "rs0", members: [{ _id: 0, host: "localhost:27017" }] }) - 成功后会自动切换为 PRIMARY 状态，
db.isMaster()返回中出现setName: "rs0" - 此时再修改配置文件，补上
replication.replSetName: rs0，下次重启才不会丢配置
添加第二个节点时连不上，常见于 bindIp 和端口暴露问题
副本集成员间通信依赖明确可访问的 host:port。本地测试时容易写 localhost:27017，但其他节点解析 localhost 会指向自己，导致连接失败；生产环境则常因防火墙或 bindIp 限制无法互通。
实操要点：
- 所有节点的
net.bindIp必须包含能被其他成员访问的 IP（如0.0.0.0或具体内网 IP），不能只写127.0.0.1 - 添加新节点用
rs.add("192.168.1.10:27017")，别用localhost或127.0.0.1 - 确认新节点的
mongod已启动，且telnet 192.168.1.10 27017可通 - 如果用 Docker，注意容器网络模式——
host模式下可用宿主机 IP，bridge下需用容器 IP 或--add-host
从 Standalone 升级后写操作短暂失败，因为 PRIMARY 切换需要时间
执行 rs.initiate() 后，原节点会经历一次选举（哪怕只有它一个成员），期间约 1–3 秒不可写，应用可能收到 NotWritablePrimary 或连接中断。这不是错误，而是副本集状态收敛的正常开销。
应对方式：
- 应用层应捕获
NotWritablePrimary错误并重试（多数官方驱动默认带重试逻辑） - 避免在
rs.initiate()后立刻执行关键写入；可轮询db.isMaster().ismaster等返回true再继续 - 不要在
initiate后立即rs.add()第二个节点——等第一个节点稳定为 PRIMARY 至少 5 秒再操作 - 如果应用使用连接字符串，确保含
?replicaSet=rs0，否则驱动可能仍当单机用，错过故障转移
oplog 大小不够导致同步延迟或失败
副本集靠 oplog 实现数据同步。Standalone 模式默认不创建 oplog，rs.initiate() 会自动建一个 5% dbPath 大小的 oplog（最小 1GB）。如果业务写入量大、或初始化后长时间没添加从节点，oplog 可能被覆盖，新节点同步时卡在 “still initializing” 或报 OplogStartMissing。
预防动作：
- 初始化前手动预置足够大的 oplog：停机执行
mongod --replSet rs0 --oplogSize 4096（单位 MB），再rs.initiate() - 上线后检查：
rs.printReplicationInfo()看oldest timestamp是否合理，maxSize是否 ≥ 2048 - 已有副本集想扩容 oplog？只能重做：备份 → 清空
local库 → 重启指定--oplogSize→rs.initiate()→ 恢复数据
真正麻烦的不是加节点，是让所有节点对“谁来记日志、日志存多久、怎么互相认对方”达成一致——这些细节没对齐，加再多节点也同步不了。
