NoSQL 与搜索 / 系统课时

执行版本升级与 FCV 切换

执行版本升级与 FCV 切换

MongoDB 升级的关键不是把二进制替换掉,而是把“可回退的二进制升级”和“启用新版本持久化特性的 FCV 切换”分成两个阶段。安全流程应先完成备份与兼容性检查,再滚动升级副本集成员,经过观察期确认稳定后才提升 featureCompatibilityVersion。

学习目标

  • 区分 MongoDB 二进制版本与 featureCompatibilityVersion 的职责。
  • 按副本集滚动升级顺序降低停机和回退风险。
  • 在切换 FCV 前后完成健康检查、观察期与验证。

把二进制升级和 FCV 拆成两道门

FCV 控制哪些会形成旧版本不兼容持久化状态的新特性可以启用,因此“所有节点已运行新二进制”不等于“应该立即提升 FCV”。更稳妥的做法是先让新二进制在旧 FCV 下运行一段观察期,确认驱动、查询、复制、备份和监控都正常,再进入 FCV 变更。

MongoDB 滚动升级与 FCV 切换流程

这也解释了为什么升级窗口里要明确两个完成标准:第一道门是所有成员的新二进制都稳定运行,第二道门才是确认不再需要快速回退后提升 FCV。把两者合并成一步,会把兼容性问题和不可逆的新特性状态混在同一个故障窗口里。

升级前建立可回退检查点

先确认目标版本支持从当前版本直接升级,并按照目标版本的官方升级路径处理跨版本限制。随后验证备份真的可恢复,而不是只看“备份任务成功”;同时检查应用驱动、ORM 或 ODM、监控代理、备份工具与目标 MongoDB 版本的兼容性。

副本集还应确认所有成员健康、没有成员处于 ROLLBACK、RECOVERING 或正在 initial sync。升级前记录当前 FCV、复制延迟、写入错误率、P95/P99 延迟和 oplog 时间窗口,后面才能判断新版本是否真的稳定。

按副本集顺序滚动替换二进制

典型顺序是先升级一个 Secondary,启动后等待它重新进入 SECONDARY 且复制追平,再处理下一个 Secondary。所有 Secondary 都验证完成后,让当前 Primary 主动降级并确认新 Primary 已选举,再升级原 Primary。每一步都只改变一个成员,故障定位和回退边界最清楚。

升级期间应用连接串应使用副本集发现机制,而不是固定只连某一台主机。这样 Primary 切换时,驱动可以重新发现拓扑并把可重试操作转移到新 Primary;仍要通过压测或演练确认业务对短暂选举窗口的实际容忍度。

经过观察期再切换 FCV

下面用 MongoDB 7.0 升级到 8.0 作为完整示例。执行这段 mongosh 代码前,应确保副本集所有成员已经运行 8.0 二进制、复制正常,并且当前 FCV 仍是 7.0。如果你的目标版本不同,只能替换为该版本官方升级路径允许的值,不能跨版本照抄。

javascript
const adminDb = db.getSiblingDB("admin");
const status = rs.status();

printjson(status.members.map(member => ({
  name: member.name,
  stateStr: member.stateStr,
  health: member.health
})));

printjson(adminDb.runCommand({
  getParameter: 1,
  featureCompatibilityVersion: 1
}));

printjson(adminDb.runCommand({
  setFeatureCompatibilityVersion: "8.0",
  confirm: true
}));

printjson(adminDb.runCommand({
  getParameter: 1,
  featureCompatibilityVersion: 1
}));

预期输出

text
[
  { name: '<HOST1>:<PORT>', stateStr: 'PRIMARY', health: 1 },
  { name: '<HOST2>:<PORT>', stateStr: 'SECONDARY', health: 1 },
  { name: '<HOST3>:<PORT>', stateStr: 'SECONDARY', health: 1 }
]
{ featureCompatibilityVersion: { version: '7.0' }, ok: 1 }
{ ok: 1 }
{ featureCompatibilityVersion: { version: '8.0' }, ok: 1 }

<HOST1>、<HOST2>、<HOST3> 和 <PORT> 取决于实际部署。若第一段健康检查出现非 PRIMARY/SECONDARY 状态或 health 不为 1,应先解决复制集异常,不要继续提升 FCV。

验证升级结果与回退边界

FCV 切换后继续观察复制延迟、错误率、慢查询、连接数、CPU、磁盘和备份任务,并执行一组覆盖核心读写、事务、索引和故障转移的回归用例。只有“服务能启动”不能证明升级成功,因为驱动兼容或查询计划变化往往要在真实负载下才暴露。

若问题发生在 FCV 提升之前,通常更容易保留旧特性兼容边界并制定回退;一旦提升 FCV并开始使用会产生新持久化状态的特性,降级限制会明显增加。此时必须按目标版本的降级文档逐项处理,不能把“把 FCV 改回旧值”当作通用回滚方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行版本升级与 FCV 切换

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通