MongoDB 5.0副本集平滑升级至6.0官方指南

MongoDB从5.0升级到6.0，最核心的一条原则——必须逐节点滚动升级，绝不能为了省事而进行全量停机或跳过FCV（Feature Compatibility Version）提升。否则，副本集会卡在STARTUP2状态，或者直接拒绝选举，导致新主节点无法写入。这并非危言耸听，而是众多运维同行用实际生产事故换来的宝贵教训。

为什么不能直接全量停机？

这里面有多个深层原因。副本集的正常运行依赖心跳机制和oplog的同步状态。一旦全量停机，所有节点同时重启，会触发“多数节点失联”的判定。在rs.status()输出中，你会发现大多数成员显示为UNKNOWN或DOWN。更棘手的是，即便所有节点都重新上线，也可能因为FCV不一致、oplog截断或electionId冲突，导致长时间无法选出主节点。

具体来说，5.0版本默认使用w:majority的writeConcern，而6.0进一步强化了复制一致性校验。当节点间FCV未对齐时，SECONDARY节点会拒绝同步新的oplog。从5.0到6.0，必须先将所有节点的二进制文件升级完毕，最后再统一提升FCV。如果提前执行setFeatureCompatibilityVersion: "6.0"，那些尚未升级的节点会直接崩溃退出。另外，升级过程中任何节点意外终止（例如OOM或磁盘满），如果没有清理mongod.lock文件，下次启动就会报DBPathInUse错误——这些都是实际踩过的坑。

滚动升级：每台节点的操作节奏

假设你有一个三节点副本集（1个PRIMARY + 2个SECONDARY），标准流程如下所示，关键在于保证始终存在一个可写的主节点：

• 首先连接当前的PRIMARY，执行rs.stepDown(60)主动降级，等待新主节点选举出来（通常需要10到30秒）。
• 选择一台SECONDARY节点，执行sudo systemctl stop mongod停止服务。
• 替换二进制文件：Ubuntu上用sudo apt-get install -y mongodb-org=6.0.15 mongodb-org-server=6.0.15，CentOS上则用sudo rpm -U mongodb-org-server-6.0.15-1.el7.x86_64.rpm。
• 启动服务：sudo systemctl start mongod，然后等待节点状态恢复到SECONDARY。通过rs.status().members[n].stateStr确认，这个过程通常需要1到2分钟，具体时间取决于oplog的大小。
• 重复上述步骤，升级第二台SECONDARY节点。等它也同步完成后，再对原先降级为SECONDARY的原主节点执行相同的升级流程。

FCV提升时机与幂等性验证

这一步非常关键，但容易被忽视。只有当所有节点都运行6.0的二进制文件，并且rs.status()显示全部为PRIMARY或SECONDARY（没有STARTUP或RECOVERING状态），才能在当前主节点上执行FCV提升：

• 使用mongo或mongosh连接，切换到admin库：use admin。
• 执行命令：db.adminCommand({ setFeatureCompatibilityVersion: "6.0" })。
• 验证生效：db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })，如果返回结果中的version字段是"6.0"，则表示成功。
• 该命令是幂等的，即使失败重试也没有问题。但注意，如果返回"node not master"，说明你连接到了从节点——必须在主节点上操作。

升级后必查的三个信号

不要仅仅因为db.version()和rs.status()表面正常就认为万事大吉。很多时候，隐藏的问题要过几个小时才会暴露出来：

• getLastError报"NotMasterNoSla veOk"：这通常意味着应用的连接池仍然是旧的，没有触发自动重连。检查驱动是否启用了retryWrites=true，同时确认连接字符串中包含replicaSet=xxx。
• 慢查询日志里出现大量"waiting for replication"：从5.0升级到6.0后，默认的writeConcern变成了{w: "majority", wtimeout: 60000}。如果某个SECONDARY节点延迟超过60秒，写操作就会超时。可以临时使用w=1进行测试，然后排查网络或磁盘I/O问题。
• mongostat显示netIn/netOut突降80%以上：很可能是mongos或客户端缓存了旧的种子节点列表。需要刷新DNS或者重建连接池。

最后，必须再次强调：FCV提升不可逆。一旦设为"6.0"，5.0的二进制节点就再也无法加入这个副本集。因此，升级前执行mongodump --archive不是走形式，而是底线保障。