概览

本文为您介绍对 MongoDB 实例进行数据库大版本升级操作的典型场景与操作建议。以 5.0 升级至 6.0 为示例，其它版本升级流程可参考本文执行。

注意事项

• 数据库大版本升级过程中将触发实例重启，建议在维护时间窗口或业务低峰期执行升级，以降低对业务的影响。
• 强烈建议在升级前进行一次全量备份。数据库大版本升级完成后，实例将无法回退至旧版本。
• 升级过程的整体耗时约为 5～10 分钟，实际时间以实例规格、数据量及系统负载为准。
• 在大版本升级过程中，实例将经历重启，同时主节点可能发生切换，切换会导致主备节点角色变化，建议采用高可用连接以确保稳定性。

支持升级的数据库大版本

当前 不支持指定目标升级版本，系统将按既定路径 逐级升级。具体版本之间的对应关系，请参考下图：

实例的数据库大版本	可升级到的数据库大版本
3.4	3.6
3.6	4.0
4.0	4.2
4.2	4.4
4.4	5.0
5.0	6.0
6.0	7.0
6.3	不支持通过控制台直接升级数据库大版本
7.0	8.0
8.0	暂无更高的数据库大版本可升级

如果您的实例版本不支持通过控制台直接升级数据库大版本，可通过 DTS 将原实例迁移至更高版本的新实例中。

若您当前正在使用 MongoDB 3.4、3.6 版本实例，建议尽早升级至更高版本，以获得更好的安全、性能和功能支持。

前期准备

为降低生产环境风险，建议在升级前完成完整的兼容性测试。

1. 驱动与客户端兼容性检查

以 Python 驱动 PyMongo 为例，不同驱动版本与 MongoDB Server 的兼容关系如下，更多请参考官方文档。

PyMongo Version	MongoDB 8.0	MongoDB 7.0	MongoDB 6.0	MongoDB 5.0	MongoDB 4.4	MongoDB 4.2	MongoDB 4.0
4.14 > 4.16	✓	✓	✓	✓	✓	✓
4.9 > 4.13	✓	✓	✓	✓	✓	✓	✓
4.4 > 4.8	⊛	✓	✓	✓	✓	✓	✓
4.2 > 4.3	⊛	⊛	✓	✓	✓	✓	✓
3.7 > 4.1	⊛	⊛	⊛	✓	✓	✓	✓

✓	支持所有功能。
⊛	该驱动程序版本将与 MongoDB 版本一起使用，但并不支持所有新的 MongoDB 功能。
✗	该驱动程序版本不适用于 MongoDB 版本。尝试连接到 MongoDB 版本将会导致错误。
无标记	驱动程序版本未使用 MongoDB 版本测试。

以 MongoDB 6.0 实例为例，建议将驱动程序升级至 4.2 及以上版本。部分低版本驱动虽然可以连接服务器，但无法支持 MongoDB 6.0 的全部新特性，可能引发兼容性风险。

• 请同步检查应用程序和部署是否与 MongoDB 6.0 版本存在兼容限制，并参考MongoDB 官方兼容性变更说明完成代码适配。

2. 建立测试环境进行验证

推荐通过从备份点创建实例的方式创建测试环境：

• 从备份点新建一个与当前生产版本一致的测试实例
• 在测试实例上执行大版本升级操作。
• 部署升级后的客户端并验证业务功能。
• 若兼容性问题，请根据报错信息调整代码直至验证通过。
• 完成验证后释放测试实例。

执行从备份点新建实例的操作将创建一个新的实例并产生相关费用。

数据库大版本升级操作流程

您可以通过控制台操作一键升级，具体流程如下：

1. 登录 MongoDB 控制台。
2. 在页面中选择需要升级版本的 集群。
3. 在 基本信息 页面 → 配置信息 中找到 数据库版本。
4. 点击 升级数据库大版本，确认目标版本及相关升级注意事项。
5. 按需选择立即升级，或指定维护时段内升级。
6. 单击 确认 后，等待任务完成。

升级后的验证流程

• 版本确认

登陆控制台，在基本信息页确认数据库版本已更新为目标版本。

• 业务验证

观察业务监控指标是否正常，执行核心读写操作与关键业务流程验证功能可用。

相关参考文档

• 升级数据库大版本
• 版本信息