MongoDB 9.0 新特性速览:
性能、安全、可观测,以及升级前要知道的事
MongoDB 9.0 于 2026 年 9 月 29 日发布,覆盖 Atlas、Enterprise Advanced、Community Edition 和自管环境。这篇文章按主题梳理它的主要变化,并给每一项标注它属于所有部署都能用的服务端能力、Atlas 专属,还是 Enterprise Advanced 专属。最后单独整理了发布说明里列出的兼容性变化和已知问题,方便你判断什么时候升级。
8.3 → 9.0
官方称相对 8.0 的最高提升
数据来自 MongoDB 的内部测试(对比 9.0 与 8.0,使用公开基准方法),均为"最高"值,因负载、部署、硬件和配置而异,不代表你自己环境里的结果。
更快,也更有边界
9.0 在提速的同时,给单个操作和并发事务加上了明确的资源上限,让一条失控的查询更难拖垮整台服务器。
单操作内存上限
单个查询操作的内存被限制在 1 GB 与服务器内存 20% 中较大的一个。超限的操作会以 ExceededMemoryLimit(146)等错误失败。每个阶段 100 MB 的限制和落盘行为保持不变。
并发事务上限
maxConcurrentMultiDocumentTransactions 默认 10000。超过后,来自外部客户端的新事务会以 TooManyOpenTransactions 失败。
explain 能看到表达式内存
在 executionStats 及以上级别,explain 会对 $project、$lookup、$match 等阶段报告 expressionEvaluationPeakMemoryBytes,方便找出吃内存的表达式。
上面的百分比都是 MongoDB 内部测试的"最高"值,并且官方对"大型部署近 2 倍吞吐"没有说明负载和规模。升级是否带来收益,最可靠的办法是用你自己的业务负载在测试环境里压一遍。
对单个查询形状的控制更细了
9.0 让你可以不改应用代码,就对某一类查询调整参数;同时,查询统计也从只看读,扩展到了写。
命令级 querySettings
find、distinct、aggregate 命令可以直接带 querySettings 文档,只对本次执行生效、不存到集群。如果该查询形状已有集群级设置,两者合并,冲突时以集群级为准。
queryKnobs
新的查询设置项,可以为某个查询形状单独覆盖内部服务器参数。需要特性兼容版本(FCV)为 9.0 或更高。
按形状设置 maxTimeMS
通过 setQuerySettings 为单个查询形状设定时间上限,不必在每个调用点改代码。同样需要 FCV 9.0 或更高。
$queryStats 覆盖写操作
统计范围扩展到 update、insert、delete,并新增 metrics.cursor、metrics.queryExec、metrics.queryPlanner、metrics.writes 等字段。默认开启,对读和写各按 1% 采样。
服务端 JavaScript 回归
$accumulator、$function、$where 在 8.0 中被弃用,9.0 重新启用,改用基于 WebAssembly 的引擎,沙箱更强。ppc64le 平台上不可用。
// $queryStats 需要在 admin 库上执行 db.getSiblingDB("admin").aggregate([ { $queryStats: {} } ])
加密状态下也能做字符串查询
9.0 里最受关注的安全变化是 Queryable Encryption 对字符串的支持,以及一批围绕认证、审计和 Atlas 网络连接的补充。
服务端 SERVER
- Queryable Encryption 正式可用:对加密字符串字段支持前缀、后缀和子串查询,数据保持加密的同时可以做部分匹配。
mongosh需要通过--cryptSharedLibPath指定 9.0+ 的自动加密共享库 mongocryptd被弃用:改用自动加密共享库useInternalAuthzForX509:设为 true 时,即使配置了 LDAP 授权,MONGODB-X509客户端也使用内部授权- 审计日志新增字段:
directRemote与direct_endpoint记录真实的 TCP 对端,不受 PROXY 协议头影响
Atlas ATLAS
- AWS PrivateLink 跨区域连接:应用与 Atlas 集群之间跨 AWS 区域建立私有连接,不暴露在公网
- Google Private Service Connect 端口映射:多个数据库节点可以通过同一个端点访问
- Azure Key Vault 无密钥认证:静态加密使用 Atlas 托管的服务主体,Atlas 里不保存长期凭据
- Google Trust Services:新增为 TLS 证书的颁发机构
少一点猜,多一点证据
9.0 在服务端补了大量新的指标,Atlas 则在界面和数据出口上做了增强。
服务端新增指标 SERVER
- serverStatus 新增大量指标,包括
changeStreams.*、repl.network.bytesSent、operation.writeConflictRetry*、query.*、shardingStatistics.* - change stream 游标指标:
cursor.open.total、cursor.open.pinned、cursor.totalOpened、cursor.lifespan - 初始同步指标:
replSetGetStatus.initialSyncStatus新增phase、totalAttempts、bytesPerSecond - 地理索引键提取错误:有了明确的错误码 510、511,失败的写入会带上出问题的路径和原因
Atlas 增强 ATLAS
- 原生 OpenTelemetry 集成:把指标、日志和 Atlas 活动事件导出到任何兼容 OpenTelemetry 的平台,官方提到的有 Datadog、New Relic、Dynatrace、Prometheus/Grafana、Google Cloud、Azure、AWS CloudWatch。可通过 Atlas 界面或 Terraform 配置
- 重新设计的指标界面:统一的集群级视图,可按分片、节点和时间范围筛选
- Query Shape Insights 覆盖写操作:按查询形状展示 insert、update、delete 的指标,帮助发现没走索引的更新和删除。9.0 起基于 1% 的随机采样,展示的总量约为实际的 1%,很少执行的形状可能不出现
流量尖峰、备份和分片运维
这一类变化大多落在 Atlas 和 Enterprise Advanced 上,但服务端也补了几个分片运维的工具。
Intelligent Workload Management
面向过载集群的托管可用性能力:把瞬时的流量尖峰排队,让短操作继续流动、长操作保持稳定,只有在万不得已时才限流多余请求,给自动伸缩或运维人员争取处理时间。
S3 备份直连数据路径
备份绕过 Ops Manager 控制平面,直接走数据路径,官方称可以更快。另外还提供存放在 S3 上的不可变、可迁移的时间点恢复(PITR)链。
恢复与维护
新增数据库级和集合级恢复、更完善的快照管理,以及可自定义的维护窗口批次(maintenance waves)。
分片排空状态
mongosh 新增 sh.shardDrainingStatus() 和 sh.getTransitionToDedicatedConfigServerStatus(),方便查看分片排空与转为专用配置服务器的进度。
checkMetadataConsistency
新增多种不一致类型的检测,并新增 performStrictChunkChecksIfBelowThreshold:块数低于阈值做完整比较,达到阈值则只比较数量。
Gen2 计算
Gen2 在 AWS 和 GCP 的 M30 及以上专用集群上可用,官方称在性价比和存储、IOPS 控制的灵活性上有改进。
时间序列与数据校验
这一组变化会影响你怎么设计数据和约束,也是升级时最需要留意的部分。
时间序列集合的存储方式
时间序列集合以单个命名空间存放压缩的 bucket,不再是可写的非物化视图,并且 renameCollection 现在可用于时间序列集合。
默认校验 BSON
服务器会校验所有写入的 BSON,遇到非法 BSON 会返回错误。
新的 constraint 校验级别
校验规则会应用于所有插入和更新,并要求所有已有文档都满足规则。适合想把应用对数据的预期直接固化在数据库里的场景。
上线之前,先把这几件事看清楚
下面的内容整理自 9.0 发布说明。已知问题的状态会随补丁版本变化,升级前请回到官方发布说明核对最新情况。
兼容性变化
- 默认校验 BSON:以往能写进去的非法 BSON,现在会报错
- 被弃用:
net.wireObjectCheck、--objcheck/--noobjcheck,以及mongocryptd - 被移除:
ShardCatalogCacheCollectionMetadataMismatch这种不一致类型 - 被改名:
shardingStatistics.databaseVersionUpdateCounters改为databaseShardingMetadataStatistics;metrics.changeStreams.showExpandedEvents移到option.下。监控脚本里引用旧名的要同步改 - 时间序列:单个库里超过 5000 个时间序列集合时,升级可能更慢,并可能出现额外的写延迟尖峰。可先删掉不需要的集合
升级前后的建议动作
- 先在测试环境演练:用真实负载验证性能和兼容性,再决定生产升级的时间
- 升级前做好备份,并确认恢复流程可用
- 记下升级前的监控基线:复制延迟、慢查询、连接数等,升级后对照
- 关注补丁版本:9.0.4(2026-10-13)修复了多个 CVE 和若干稳定性问题
- FCV 要分步走:部分新特性(如
queryKnobs)需要 FCV 9.0,别急着一次提升
ShardingTaskExecutorPoolMinSize 个连接,可能把配置服务器的连接耗尽
如果该参数大于 1,升级前把 ShardingTaskExecutorPoolMinSizeForConfigServers 设为 1(专用配置服务器);嵌入式配置服务器请联系 MongoDB 支持
listIndexes 会返回 collation: { locale: "simple" },部分 ODM(Mongoose、Doctrine ODM、Beanie)会误判为索引定义变了,Mongoose 的 syncIndexes() 可能删除并重建没有变化的索引
避免在启动时调用 syncIndexes(),改用 createIndexes() 或 diffIndexes();Mongoose 9.10.4 或 8.24.5 已修复
initialSyncMethod 设为 logical 重启,或清空 dbPath 后重启;Atlas 用户请联系 MongoDB 支持
升级前后建议做两件事:一是备份,二是对照监控基线。这两步正好对应 WAP 的备份与监控模块。具体到 WAP 对 9.0 的支持情况,请以 WAP 文档为准。另外,Atlas Infinite 的公开预览版运行的正是最新的 9.x。
