您可以随时通过 修改 Atlas 集群来升级 Atlas 集群的主要版本。
为了确保您顺利过渡到新的 MongoDB 版本并且不会影响您的应用程序，在生产 Atlas 集群上升级主要版本之前，请使用以下过程创建过渡集群并根据新的 MongoDB 版本测试您的应用程序。
Considerations
以下注意事项适用：
升级之前，您的集群必须处于正常状态。
如果您在主要版本升级前拍摄按需快照，请等待快照完成后再升级版本。
如果您将集群从较低版本升级到MongoDB 8.0，请注意Atlas中的写入阻塞行为。为确保升级到MongoDB 8.0 后专用集群的主节点 (primary node in the replica set)节点写入不会被阻止，请执行以下操作：
升级后，检查集群是否有足够的存储容量来处理工作负载。
启用存储自动伸缩，在磁盘利用率超过 90% 时自动伸缩集群存储，并确保一致的工作负载可用性和性能。
每个主要版本均包含某些可能无法与以前版本向后兼容的功能。升级到新的主要版本时，请查看 发布说明，了解可能影响您的应用程序的更改。
或者，如果您使用Stable API，请确保MongoDB版本之间的行为更改不会在升级后破坏您的应用程序。
MongoDB稳定版API包含MongoDB命令的子集，应用程序使用这些命令读取和写入数据、创建集合和索引以及执行其他常见任务。稳定的API：
允许您指定应用程序运行的MongoDB API版本，并为应用程序提供长期的API稳定性。
支持更频繁的发布和自动服务器升级，使您的应用程序能够利用快速发布的功能，而不必冒向后不兼容更改的风险。
限制
以下限制适用于您升级集群版本的操作：
您无法升级到比固定的 特征兼容性版本高 2 个版本。如果集群固定到特征兼容性版本 6.0，则只能升级到 7.0，不能升级到 8.0+。要了解如何为您的集群固定特征兼容性版本，请参阅“为您的集群固定特征兼容性版本”。
您一次只能升级Atlas 集群一个主要版本。升级集群时无法跳过任何主要版本。
升级 MongoDB 主版本后，您无法降级到之前的版本，除非在升级前固定了集群的特征兼容性版本。
实时迁移要求源集群和目标集群的特征兼容性版本必须匹配其主版本号。要学习有关支持的迁移路径的更多信息，请参阅迁移或导入数据。
重要
如果计划使用实时迁移，请勿为专用集群选择 Latest Version With Auto Upgrades。此选项会自动将集群升级到最新的次要发布。实时迁移仅支持主要版本，不支持次要版本，例如MongoDB版本 8.2。
从 MongoDB 6.0 开始，
$$SEARCH_META聚合变量不能在$searchMeta阶段之后的任何后续阶段使用。如果您想从以前的版本升级到MongoDB 6.0，并在MongoDB搜索
$searchMeta查询中使用$$SEARCH_META聚合变量，请在升级集群之前查看，以免出错。
必需的访问权限
要升级集群，您必须具有项目的 Project Owner 或更高角色。
升级MongoDB主版本
要升级MongoDB主版本：
在Atlas中，转到项目的Clusters 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Clusters。
会显示集群页面。
为过渡环境创建 Atlas 集群。
注意
如果已经有 Atlas 集群作为过渡环境，则可以跳过此步骤。
单击 Create 按钮，打开集群创建模式。配置暂存集群以匹配生产集群。不必为暂存集群启用备份。
要了解如何创建新集群，请参阅创建集群。
重要
如果为暂存集群选择较小的集群层， 请考虑运行的任何性能测试 可能无法代表升级后的生产集群的性能。 您可能还需要根据 要镜像到暂存集群的数据量来选择更大的存储大小。
（可选）将您的应用程序升级到最新的 MongoDB 驱动程序。
将应用程序升级到适用于集群MongoDB版本的最新MongoDB驱动程序，即可完全访问权限较新MongoDB版本提供的功能。您还可能会发现较新的驾驶员版本具有更好的性能或稳定性。有关给定MongoDB版本的推荐MongoDB驾驶员的文档和连接示例，请参阅通过客户端库连接到集群。通过使用 Stable API，您可以确保MongoDB版本之间的行为更改不会破坏您的应用程序。
如果升级应用程序后遇到错误，请在 JIRA 项目中为您的 MongoDB 驱动程序提交工单。
在Atlas中，转到项目的Clusters 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Clusters。
会显示集群页面。
将生产集群升级为目标 MongoDB 版本。
对暂存集群的性能和操作有信心后，请对生产集群重复升级过程：
使用较新的MongoDB驱动程序升级生产应用程序，并测试其是否正常运行。此步骤可确保您的应用程序在数据库升级之前与新的MongoDB版本兼容。
准备好应用程序后，升级生产集群上的MongoDB版本。当Atlas完成升级后，请检查应用程序是否正常连接和运行。
如果升级后的生产集群出现问题， 请使用以下部分的过程提交一个高优先级支持票证。
在升级期间管理功能兼容性 (FCV)
Atlas和本地部署部署均支持MongoDB主要版本升级。 FCV启用或禁用保留与早期版本MongoDB不兼容的数据的功能。您可以在Atlas中升级之前锁定集群的FCV ，这样您就可以在升级后将MongoDB恢复到以前的版本，而不会遇到版本兼容性问题。
警告
FCV是一种短期指标，在固定日期后最多仅持续 4周，并且不会模拟以前二进制版本的行为。它仅推迟升级某些支持新服务器功能的内部数据结构。 在确信无需降级到以前的版本后，取消固定FCV以匹配当前的二进制版本。
有关如何固定和取消固定特征兼容性版本以及如何将集群降级一个主要版本的更多信息，请参阅为集群降级主要 MongoDB 版本。
联系支持人员
如果您对迁移支持有任何超出本文档范围的问题， 或者在迁移过程中遇到错误， 请通过 Atlas 用户界面提交支持工单。