升级驱动版本
概述
本页描述了您在升级到 C 驱动程序新版本时必须对应用程序进行的更改。
升级前，执行以下操作
确保新的 C 驱动程序版本与您的应用程序连接的 MongoDB 服务器版本以及应用程序运行的平台兼容。有关版本兼容性信息，请参阅C 驱动程序兼容性页面。
在重大变更部分中处理您当前使用的驱动程序版本和计划升级版本之间的任何重大变更。要了解更多关于 MongoDB 服务器版本兼容性变更的信息，请参阅服务器版本兼容性变更部分。
提示
为了在将来升级驱动程序版本时最小化应用程序所需的更改数量，请使用稳定 API。有关更多信息，请参阅稳定 API指南。
重大变更
注意
C驱动程序遵循语义版本控制。 该驱动程序在任何版本中都可能破坏构建系统或软件包兼容性。修补版本可能会撤销意外破坏API的更改。
破坏性更改是指在驱动程序特定版本开始时对约定或行为的更改。如果在此升级驱动程序之前未解决此类更改，则可能阻止您的应用程序正常工作。
本节中的破坏性更改按引入它们的驱动程序版本进行分类。在升级驱动程序版本时，解决当前版本和升级版本之间的所有破坏性更改。
示例
从版本1.26升级
如果您正在将C驱动程序从版本1.26升级到版本1.27，如果有的话，解决1.27.0到1.27.6版本中列出的所有破坏性更改。
版本1.24.0破坏性更改
libmongoc 1.24.0版本的libmongoc，C驱动程序所组成的库之一，引入了以下向后不兼容的更改
使用查询加密需要MongoDB服务器版本7.0及更高版本。
服务器发布兼容性更改
服务器发布兼容性更改是对驱动程序的修改，这将停止对一组MongoDB服务器版本的支持。
驱动程序在达到生命周期的末尾（EOL）后停止支持MongoDB服务器版本。
有关MongoDB对EOL产品的支持的更多信息，请参阅旧版支持策略。
版本1.28.0发布支持更改
此驱动程序版本取消了对MongoDB服务器版本3.6及以下版本的支持。要使用1.28.0版本及更高版本的任何驱动程序，您的MongoDB服务器版本必须是4.0或更高。此驱动程序版本支持MongoDB服务器8.0的功能。有关如何升级MongoDB服务器部署的信息，请参阅MongoDB服务器手册中的发行说明。