MongoDB 副本集从 4.4 升级到 6.0 时，必须严格遵循 4.4→5.0→6.0 的官方顺序分阶段执行，任何中间主版本都不能跳过，否则极易引发服务无法启动、数据文件损坏、索引异常甚至副本集状态紊乱等问题；同时还需要同步处理 FCV 版本变更，按副本集逐节点完成升级，并提前做好驱动版本、应用程序以及配置参数的兼容性适配。
MongoDB 不能直接从 4.4 升级到 6.0，正确做法是先升级到 5.0，确认稳定后再继续升级到 6.0。
必须走 4.4 → 5.0 → 6.0 的分步升级路径
跳过中间主版本升级（例如直接替换 mongod 二进制文件）很容易造成服务启动失败、数据损坏或索引异常。MongoDB 官方明确不支持跨主版本跳级升级，主要原因包括：
featureCompatibilityVersion（FCV）是升级过程中的关键门槛：4.4 副本集必须先保持为"4.4"，升级到 5.0 后再切换为"5.0"，最后才能继续升级到 6.0 并设置为"6.0"- WiredTiger 存储引擎的数据格式在 5.0 和 6.0 中都发生过调整，若跳过版本，可能直接触发数据校验失败
- 部分命令行为（如
collMod参数）、聚合逻辑（如allowDiskUse的默认处理方式）在 5.0 已有变化，到了 6.0 又进一步收紧和规范
升级前必须检查驱动和应用兼容性
很多升级问题并不一定是数据库服务本身故障，而是驱动不兼容、应用无法连接或查询结果异常，这些情况在实际升级中尤其容易被忽略：
- Python 的
pymongo：如果 4.4 环境中使用的是pymongo==3.12，在 6.0 上可能无法正确解析新的$searchMeta或变更流恢复令牌格式 - Ja va 驱动：如果仍在使用已经废弃的
mongo-ja va-driver，建议提前替换为mongodb-driver-sync4.11+ 版本 - 应用代码中如果显式依赖了已移除或已禁用的功能，例如
db.eval()（5.0 起禁用）、geoNear旧语法，或text索引与通配符索引混合使用，升级后都可能报错 - 监控工具（如 Prometheus exporter）如果硬编码了
/adminCommand接口路径，6.0 的权限模型调整后可能会导致监控采集失败
副本集节点必须逐个升级，且顺序不能错
MongoDB 副本集升级必须遵循 Secondary 先升级、Primary 最后升级的原则，这不是建议，而是标准要求：
- 升级 Secondary 节点前，必须确认其复制同步已经完成（
rs.status().members[n].stateStr === "SECONDARY"且optimeDate与 Primary 足够接近） - 处理 Primary 节点前，先执行
rs.stepDown(60)让其主动让出主节点角色，避免强制切换带来写入中断或数据丢失风险 - 每个节点重启后，都要确认
rs.status().members[n].health === 1，并且stateStr恢复为"SECONDARY"或"PRIMARY"，之后才能继续操作下一个节点 - 单个节点升级完成后不要立即修改 FCV；应等所有节点都已经运行在新的 MongoDB 二进制版本上，再统一执行
db.adminCommand({setFeatureCompatibilityVersion: "X.0"})
配置文件和磁盘空间是常见风险点
MongoDB 6.0 对配置项、系统资源和运行环境更加敏感，以下几个细节尤其容易踩坑：
storage.wiredTiger.engineConfig.journalCompressor：4.4 默认值是"snappy"，而 6.0 强制要求使用"zstd"，如果未提前调整，mongod启动时可能直接报错net.ssl.mode：6.0 的默认值由"preferSSL"变为"requireSSL"，如果未正确配置证书，服务可能直接拒绝客户端连接allowDiskUseByDefault: true：从 6.0 开始默认允许使用磁盘临时文件，如果/var/lib/mongodb所在分区剩余空间不足 10GB，大型聚合查询可能因为磁盘空间不足而静默失败- 日志轮转：6.0 默认启用
systemLog.logRotate: "rename"，如果systemLog.path对应目录的 inode 不足，mongod可能卡在启动阶段无法继续
在 MongoDB 4.4 副本集升级到 6.0 的过程中，真正最棘手的通常不是执行升级命令本身，而是 FCV 切换和驱动适配这两个关键环节——一旦这里处理不当，数据库表面上看似运行正常，应用侧却可能持续出现连接超时、查询返回空结果或功能异常；相比升级窗口内那些可控的操作，这类兼容性问题往往更隐蔽，排查和修复成本也更高。
