版本说明

新增功能

• 当服务器响应包含 SystemOverloadedError 并其值为 baseBackoffMS 时，驱动程序会使用该值而不是其默认延迟来计算重试前的等待时间。

• 为集合批量写入选项添加 getter。

改进

• 将捆绑的 utf8proc 库更新为 2.11.3。

有关此发布的更多信息，请参阅 25v..0 发布说明。

新增功能

• Queryable Encryption String 算法 (MONGOC_ENCRYPT_ALGORITHM_STRING) 已普遍可用，并支持 prefix、suffix 和 substring 查询类型。

  • prefixPreview、suffixPreview 和 substringPreview 查询类型仍处于实验阶段。

• 添加 API 以获取和设置快照会话上的快照时间。

• 添加对 AWS STS 区域终结点的支持。

改进

• 将所需的 libmongocrypt 版本从 1.15.1 提高到 1.20.0 以支持正在使用的加密。此要求对应于 ENABLE_CLIENT_SIDE_ENCRYPTION CMake 选项。

弃用

• 取消 Queryable Encryption Text API，转而使用 String API。使用 mongoc_client_encryption_encrypt_string_* 而不是 mongoc_client_encryption_encrypt_text_* 来匹配常规可用的 String 算法。

修复

• 修复对 bulkWrite 回复中详细结果的处理。

• 修复了 SCRAM 回复的处理。

有关此发布的更多信息，请参阅 24v..0 发布说明。

修复

• 修复使用 CMake 4.4.0 配置驱动程序时发生的错误。

• 修复在 Windows 上使用 UNICODE 构建驱动程序时出现的问题。

• 增加了对 HTTP 处理的更严格验证。

有关此发布的更多信息，请参阅 23v..3 发布说明。

修复

• 修复了 v2.3.0 中引入的问题失败的 killCursors 操作导致应用程序崩溃。

• 修复 SCRAM 身份验证中的错误处理。

有关此发布的更多信息，请参阅 23v..2 发布说明。

修复

• 修复 bson_new_from_buffer 中的长度检查。

• 修正 Sphinx 9.0+上的文档生成。

改进

• 在处理启用了 BIO_FLAGS_AUTO_EOF 的旧式读取回调中的 EAGAIN 错误时，提高与 OpenSSL 4.0.0 的向前兼容性。

• 改善解压消息长度限制。

修复

• 将用户名传播到自定义 OIDC 回调。

• 修正 Sphinx 9.0+上的文档生成。

有关此发布的更多信息，请参阅 23v..1 发布说明。

改进

• bson_t 可轻松重新定位。

弃用

• 弃用 bson_append_array_begin()。请使用 bson_append_array_builder_begin() 或 bson_append_array_unsafe_begin()。

新增功能

• 增加对智能工作负载管理 (IWM)和入口连接限速的支持。驱动程序可处理写入阻塞场景，并在高负载条件下优化连接建立，以维护应用程序的可用性。这些功能将在运行 MongoDB 9.0 及更高版本的 Atlas 集群上可用。

  • 所有命令均支持此功能。

  • 我们建议升级到此驱动程序版本，以避免与超载错误相关的服务器变更影响。如果您未升级，请调整自定义重试逻辑以处理更高的超载错误率。

  • 添加 maxAdaptiveRetries URI 选项，以配置失败并返回 SystemOverloadedError 的操作的最大重试次数。默认值为 2。

  • 添加 enableOverloadRetargeting URI 选项，用以控制 SystemOverloadedError 的重试是否尝试使用不同的服务器。默认值为 false。

• 添加对在初始化后以每个客户端或每个连接池为基础添加客户端握手元数据的支持。

  • 添加 mongoc_client_append_metadata() 和 mongoc_client_pool_append_metadata() 函数，这些函数对包装 C 驱动程序以自我识别的项目很有用。

• 将 Kubernetes 添加为 MONGODB-OIDC 身份验证的凭证提供商。

改进

• 对客户端超时上的游标处理做出以下改进：

  • 在游标接收客户端超时后发送 killCursors。

  • 如果变更流在重复的客户端超时后恢复，则提前退出。

删除

• 删除对 macOS 13 及更早版本的支持。使用 macOS 14 或更新版本。

有关此发布的更多信息，请参阅 23v..0 发布说明。

修复

• 提高 bson_get_monotonic_time() 在Windows平台上的分辨率。

• 删除对 Visual Studio 2015 的支持。支持的最低版本是 Visual Studio 2017。

弃用

• 不再支持macOS 11 和 macOS 12

新增功能

• 引入以下 MONGODB-OIDC身份验证机制功能：

  • 添加对使用 mongoc_client_set_oidc_callback 和 mongoc_client_pool_set_oidc_callback 的自定义回调的支持。

  • 通过属性environment:azure 添加对Azure环境的支持。

  • 通过属性environment:gcp 添加对GCP环境的支持。

  • 此发布不支持Kubernetes环境。

• 将以下功能添加到 mongoc_bulkwrite_t：

  • 添加 mongoc_bulkwrite_is_acknowledged 函数。

  • 添加 mongoc_bulkwriteresult_serverid 函数。

  • 添加对Queryable Encryption操作的支持。

• 为Queryable Encryption添加了对文本索引的以下支持：

  • 添加 mongoc_client_encryption_encrypt_text_opts_t 类型。

  • 仅为实验性工作负载添加对子字符串、前缀和后缀搜索的预览支持。这些功能不稳定，在正式发布 (GA) 之前无法保证其安全性。这些功能的 GA 版本可能无法与预览版本向后兼容。

• 通过Windows安全渠道在Windows平台上添加对 TLS v1.3 的支持。

修复

• 迭代关闭的变更流时不尝试恢复。

• 删除对 Visual Studio 2015 的支持。支持的最低版本是 Visual Studio 2017。

• 将所需的 libmongocrypt 版本从 1.13.0 提高到 1.15.0。这支持“正在使用的加密” ，并对应于 CMake ENABLE_CLIENT_SIDE_ENCRYPTION 选项。

弃用

• 弃用了对 macOS 11 和 macOS 12 的支持。

有关此发布的更多信息，请参阅 22v..0 发布说明。

修复

• 修复以下常见漏洞和披露 (CVE) 问题：如果传递了大量选项，带选项的批量写入会读取无效内存。要了解更多信息，请参阅相关 CVE-2025-12119 问题。

有关此发布的更多信息，请参阅 21v..2 发布说明。

修复

• 不再在 CMake 目标中传播 -fPIC 标志。

• 将写入命令行为应用于 mongoc_collection_create_indexes_with_opts() 函数。

• 省略单线程监控命令中的 saslSupportedMechs字段。

有关此发布的更多信息，请参阅 21v..1 发布说明。

修复

• 对于非 Windows 环境，卸载脚本现在调用 find "$dir" -maxdepth 1 命令来检测非空目录，而不是调用 ls --almost-all 命令，后者在 macOS 上不受支持。

• 对于Windows环境，卸载脚本不再因不正确的非零 %ERRORLABEL% 值而“成功”。

• 删除了对Debian 9 和Debian 10 的支持。

改进

• 将 CMake 策略最高版本设置为 4.0。之前未设置最高版本。

修复

• 对于非 Windows 环境，卸载脚本现在调用 find "$dir" -maxdepth 1 命令来检测非空目录，而不是调用 ls --almost-all 命令，后者在 macOS 上不受支持。

• 对于Windows环境，卸载脚本不再因不正确的非零 %ERRORLABEL% 值而“成功”。

• 添加 Window 安全通道支持，以使用较新的签名验证客户端证书。

• 将 rand() 的使用替换为线程安全的替代方案。

• 删除了对Debian 9 和Debian 10 的支持。

改进

• 将支持的最低MongoDB Server版本从 4.0 更新到 4.2。

• 将 CMake 策略最高版本设置为 4.0。之前未设置最高版本。

• 删除无用的长期缓冲区以减少内存使用量。

• 改进了Windows API 生成的错误消息。

修复

• 修复了Windows上的 bson_strerror_r 消息。

• 修复Windows安全通道的内存泄漏问题。

• 修复使用Windows安全通道加载 PKCS#8 RSA 密钥的问题。

有关此发布的更多信息，请参阅 20v..2 发布说明。

修复

• 修复 macOS 操作系统上的 CMake 4 配置错误

修复

• 修复了将C驱动程序配置为使用安全传输或安全渠道库时出现的 MONGODB-X509 身份验证的用户名处理问题

• 当 mongoc_bulkwrite_execute() 函数在首次写入操作后生成客户端错误时，不再使用部分结果填充 mongoc_bulkwritereturn_t.res

有关此发布的更多信息，请参阅 20v..1 发布说明。

新增功能

• 添加对BSON二进制向量子类型的支持。要学习；了解更多信息，请参阅 libbson API文档中的BSON二进制向量子类型。

新增功能

• 支持聚合操作，其中包括正在使用的加密的 $lookup 阶段。要学习；了解更多信息，请参阅MongoDB Server手册中的以下参考资料：

  • $lookup 和 $graphLookup 行为 用于 CSFLE

  • $lookup 和 $graphLookup 行为 适用于 QE

有关此发布的更多信息，请参阅 v.2 0发布说明。

修复

• 修复以下常见漏洞和披露 (CVE) 问题：如果传递了大量选项，带选项的批量写入会读取无效内存。要了解更多信息，请参阅相关 CVE-2025-12119 问题。

有关此发布的更多信息，请参阅 130v..6 发布说明。

新增功能

• 预计 v2.0发布，为 bson 添加了新的 CMake 包和导入目标，以便您在不修改 CMake项目的情况下支持这两个主要版本。

  • 要使用新名称导入 bson，请为 bson包调用 find_package。新导入的目标名称为 bson::static、bson::shared 和 bson::bson。

新增功能

• 预计 v2.0发布，为 bson 和 mongoc 添加了新的 CMake 包以及导入的目标，以便您在不修改 CMake项目的情况下支持这两个主要版本。

  • 要使用新名称导入 mongoc，请为 mongoc包调用 find_package。新导入的目标名称为 mongoc::static、mongoc::shared 和 mongoc::mongoc。

  • 要使用新名称导入 bson，请为 bson包调用 find_package。新导入的目标名称为 bson::static、bson::shared 和 bson::bson。

有关此发布的更多信息，请参阅 130v..3 发布说明。

弃用

• 弃用对Debian 9 和Debian 10 的支持

改进

• 改进了嵌套文档的BSON到JSON序列化的性能

修复

• 更新 bson_as_json_with_opts() 函数的截断输出，以不再分割有效的 UTF-8 序列

• 通过以下方式更新生成的JSON文本：

  • 用一个空格序列化所有空数组和文档

  • 将驱动程序由于最大递归限制而省略的数组序列化为 [ ... ] 而不是 { ... }

  • 对旧版 CodeWScope 文档应用最大递归限制

• 修复了调用 bson_append_array_builder_begin() 函数不成功后输出参数泄漏的问题

弃用

• 弃用对Debian 9 和Debian 10 的支持

新增功能

• 添加对结构化日志记录的支持。 要配置此功能，请使用 mongoc_client_set_structured_log_opts() 和 mongoc_client_pool_set_structured_log_opts() 函数。

• 新增对“正在使用的加密”数据加密密钥的缓存生命周期配置的支持。 要配置此功能，请使用 mongoc_auto_encryption_opts_set_key_expiration() 和 mongoc_client_encryption_opts_set_key_expiration() 函数。

  要了解有关正在使用的加密的更多信息，请参阅MongoDB Server手册中的正在使用的加密。

• 添加对更新和替换操作的 sort 选项的支持。

• 添加了对使用 mongoc_bulkwrite_new() 和 mongoc_bulkwrite_set_client() 函数构造没有客户端的mongoc_bulkwrite_t 类型的支持。

改进

• 提高了 mongoc_server_description_new_copy() 函数的性能

修复

• 包括 SDAM 规范： 所需的以下 APM事件修复：

  • 传递 server_opening事件后，驱动程序必须传递相应的 server_closed事件，然后才能传递 topology_closed

  • 在传递 topology_closed事件之前，驱动程序会传递一个 topology_changed事件，该事件的 new_description 类型为 Unknown

• 修复了驱动程序在客户端批量写入的详细结果中报告插入的文档 ID 时可能发生的崩溃

有关此发布的更多信息，请参阅 v.1 30发布说明。

弃用

• 弃用了 bson_string_t 和相关函数

• 弃用编译 BSON_MEMCHECK

• 弃用了 bson_in_range_*() 和 bson_cmp_*() 函数

• 弃用了 bson_atomic_*() 和 bson_thrd-yield() 函数

• 弃用了 bson_as_json() 和 bson_array_as_json() 函数

弃用

• 弃用了 mongoc_client_command。 请改用 mongoc_client_command_simple。

• 弃用了 mongoc_database_command。 请改用 mongoc_database_command_simple。

• 弃用了 mongoc_collection_command。 请改用 mongoc_collection_command_simple。

有关此发布的更多信息，请参阅 v.1 29发布说明。

新增功能

• 添加 bson_validate_with_error_and_offset() 函数

新增功能

• 新增对“正在使用的加密”范围查询的支持

• mongoc_collection_insert_one 包括插入ID

• 添加新的批量写入API mongoc_bulkwrite_t

• Adds serverMonitoringMode URI option

弃用

• 弃用了 *_hint 选项。 请改用 *_server_id 选项。

  • 弃用了 mongoc_bulk_operation_set_hint。 请改用 mongoc_bulk_operation_set_server_id。

  • 弃用了 mongoc_bulk_operation_get_hint。 请改用 mongoc_bulk_operation_get_server_id。

  • 弃用了 mongoc_cursor_set_hint。 请改用 mongoc_cursor_set_server_id。

  • 弃用了 mongoc_cursor_get_hint。 请改用 mongoc_cursor_get_server_id。

• 弃用了 ENABLE_SSL=LIBRESSL 和 mongoc_stream_tls_libressl_new。

• 弃用了Windows平台上的 ENABLE_SASL=CYRUS 和 CYRUS_PLUGIN_PATH_PREFIX 选项。

有关此发布的更多信息，请参阅 v.1 28发布说明。

修复

• 修复特殊BSON 类型的格式错误的扩展JSON的处理

修复

• 修复 TSan 警告

• 修复C23 编译

改进

• 记录ACID 事务中命令错误的预期行为

修复

• 修复了大字符串处理 bson_append_utf8

修复

• 修复了在 bool 或 _Bool 为宏的环境中可能出现的构建错误

修复

• 修复了 Visual Studio 2013 的构建问题

修复

• 修复读取格式错误的有线协议消息时可能出现的崩溃

• 修复了 Visual Studio 2013 的构建问题

更改

• 引入有关开发流程的更改，包括新的代码签名和依赖项跟踪。 行为或API没有更改。

修复

• 将捆绑的zlib从 1.2.3 升级到 1.3.1

修复

• 修复时区中冒号的解析

• 修复了以下错误：无法初始化子文档 bson_iter_visit_all

修复

• 关闭与远程服务器的剩余连接

新增功能

• 检查环境变量 MONGO_EXPERIMENTAL_SRV_PREFER_TCP 以优先选择 TCP 而不是 SRV 查找

修复

• 修复了 bson_string_new 和 bson_string_append 中的大字符串处理

修复

• 修复使用空密码配置客户端时可能出现的崩溃

新增功能

• 将数据库名称添加到命令事件 mongoc_apm_command_failed_get_database_name 和 mongoc_apm_command_succeeded_get_database_name

• 支持用于正在使用的加密的委托 KMIP协议

• 支持为每个客户端设置套接字超时

修复

• 修复迭代 bson_strfreev

修复

• 修复了使用包含不完整数据的损坏数据数据块调用 mongoc_gridfs_file_readv 时可能出现的挂起问题

• 修复了连接到早于 4.2 的MongoDB服务器版本时使用传统耗尽游标协议进行断言的问题

修复

• 使用对齐分配 bson_array_builder_t

修复

• 修复了使用 64 位进行 32 位编译的问题 time_t

新增功能

• 支持命名KMS提供商

• 如果可能，将分片的片集群中的重试重定向到另一个mongos

改进

• 在源中添加 VERSION_CURRENT文件以简化构建

• 考虑更多可重试的错误