必须先确认所有分片节点和config server均运行4.4最新补丁版且FCV统一设为"4.4",否则升级至5.0后集群将拒绝启动或元数据不一致;需逐节点检查并设置FCV,停用balancer,替换已删除命令,验证驱动兼容性,并预留充足磁盘空间执行备份。

必须先确认所有分片节点都已运行 4.4 最新补丁版本,且 featureCompatibilityVersion 统一设为 "4.4";否则升级到 5.0 后集群会拒绝启动或出现元数据不一致。
检查所有副本集成员的 FCV 和版本一致性
FCV(Feature Compatibility Version)不是可选配置,而是强制开关。MongoDB 5.0 要求整个分片集群——包括所有分片副本集、config server 副本集(CSRS)——都必须将 featureCompatibilityVersion 设为 "4.4",且不能残留 "4.2" 或未设置状态。
- 逐个连接每个
mongod实例(包括 config server 和所有分片成员),运行:db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }) - 若返回值不是
{ "featureCompatibilityVersion" : { "version" : "4.4" } },需先在该节点上执行:db.adminCommand({ setFeatureCompatibilityVersion: "4.4" }) - 执行前确保该节点是副本集 secondary,或已在维护窗口内完成主从切换;
setFeatureCompatibilityVersion在 primary 上执行会触发一次全量 oplog 回滚检查,耗时且可能阻塞写入
验证负载均衡器和迁移状态
升级过程中任何正在进行的数据迁移都会导致 config server 元数据脏写,轻则升级后 balancer 卡死,重则分片间数据不一致。
- 连接任意
mongos,确认 balancer 已停:sh.getBalancerState()
返回false - 检查是否还有迁移任务残留:
sh.getBalancerStatus()
输出中"inBalancerRound"必须为false,且"activeMigrations"数组为空 - 如果
sh.stopBalancer()返回超时,说明有迁移卡住,需手动检查config.migrations集合是否有未完成文档,并用sh.stopBalancer(true)强制终止(仅限紧急情况)
驱动与命令兼容性预检
MongoDB 5.0 删除了多个旧命令和参数,但不会在升级时主动报错——它们会在应用第一次调用时静默失败或抛出新错误,排查成本极高。
- 检查应用代码中是否还在用:
db.collection.ensureIndex()、db.collection.save()、rs.secondaryOk()等已删除接口;必须替换为createIndex()、insertOne()、Mongo.setReadPref() - 检查监控脚本或运维工具是否依赖
shardConnPoolStats——它已被connPoolStats替代,字段结构也不同 - 确认所有驱动版本满足最低要求:Node.js 驱动需 ≥ 4.1.0,Python PyMongo ≥ 4.0.0,Java Driver ≥ 4.3.0;低于这些版本可能无法解析 5.0 新增的 wire protocol 字段
备份与存储空间再确认
升级本身不改数据文件格式(WiredTiger 格式从 4.2 起就稳定),但升级后首次启动会触发统计信息重建和索引优化,临时 I/O 和磁盘占用可能翻倍。
- 确保每个分片的
dbpath所在磁盘剩余空间 ≥(集合大小 + 索引总大小) × 2 / 分片数;例如 3TB 数据 + 600GB 索引、共 6 个分片,则每台分片服务器至少预留 1.2TB 空闲空间 - config server 的
dbpath同样要留足空间——虽然它数据量小,但升级过程中会密集写入config.changelog和config.version - 执行完整
mongodump --archive备份前,先在 config server 上运行db.fsyncLock()锁库,再 dump,避免元数据与分片数据不同步
最容易被跳过的其实是 config server 副本集的 FCV 检查——很多人只扫了分片,忘了 CSRS 也得设成 "4.4";而一旦 config server 的 FCV 不对,整个集群升级后 mongos 就连不上,报错却是模糊的 "Failed to load clusterID from config database",得重进 config server 手动修,耽误两小时以上。


















